@poe-platform/safe-js 0.1.231 → 0.1.233

package/dist/safe-js/chunks/{chunk-5SF3QHIJ.js → chunk-4EKZGMNU.js}

@@ -3466,7 +3466,7 @@ var Parser = class {
         throw new Error("for await requires an of loop.");
       }
       if (iterationOperator?.value === "in") {
-        const left = this.parseForInLeft();
+        const left = this.parseForOfLeft();
         this.expectKeyword("in");
         const right = this.parseExpression().node;
         this.expectPunctuator(")");
@@ -3520,14 +3520,6 @@ var Parser = class {
       };
     });
   }
-  parseForInLeft() {
-    const left = this.parseForOfLeft();
-    const target = left.type === "VariableDeclaration" ? left.declarations[0]?.id : left;
-    if (target?.type !== "Identifier") {
-      throw new Error("for...in keys are strings; destructure inside the body");
-    }
-    return left;
-  }
   parseForOfLeft() {
     if ((this.currentToken().type === "keyword" || this.currentToken().type === "identifier") && (this.currentToken().value === "const" || this.currentToken().value === "let" || this.currentToken().value === "var")) {
       return this.parseForOfDeclaration();
@@ -9885,7 +9877,7 @@ async function bindAssignmentPattern2(pattern, value, target, scope, context, re
   }
   return bindPattern2(pattern.left, defaultValue.value, target, scope, context, reference);
 }
-async function bindPatternValue(pattern, readValue, target, scope, context) {
+async function bindPatternValue(pattern, readValue, target, scope, context, onRead) {
   let member = pattern;
   while (member.type === "AssignmentPattern" || member.type === "RestElement")
     member = member.type === "AssignmentPattern" ? member.left : member.argument;
@@ -9899,6 +9891,7 @@ async function bindPatternValue(pattern, readValue, target, scope, context) {
   const release = context.budget === void 0 ? () => void 0 : retainValues(context.budget, () => [reference?.object, reference?.key, value]);
   try {
     value = (await readValue()).value;
+    onRead?.(value, reference);
     return await bindPattern2(pattern, value, target, scope, context, reference);
   } finally {
     release();
@@ -9906,7 +9899,10 @@ async function bindPatternValue(pattern, readValue, target, scope, context) {
 }
 async function bindArrayPattern2(pattern, value, target, scope, context) {
   const budget = context.budget ?? new Budget();
-  const iterator = await acquireSandboxIterator(
+  const saved = pattern.nodeId === void 0 ? void 0 : context.restoredPatternState?.(pattern.nodeId);
+  if (saved !== void 0 && saved.kind !== "array-pattern") throw new TypeError("Invalid array pattern continuation.");
+  const callContext = context.callContext ?? { stack: [], thisValue: void 0, getProperty: context.getProperty };
+  const iterator = saved === void 0 ? await acquireSandboxIterator(
     value,
     budget,
     context.callContext ?? {
@@ -9914,9 +9910,9 @@ async function bindArrayPattern2(pattern, value, target, scope, context) {
       thisValue: void 0,
       getProperty: context.getProperty
     }
-  );
+  ) : "kind" in saved.iterator ? await restoreSandboxIterator(saved.iterator, budget, callContext) : saved.iterator;
   if (iterator === void 0) throw new TypeError("Array destructuring requires an iterable.");
-  let done = false;
+  let done = saved?.done ?? false;
   const next = async (readValue = true) => {
     if (done) return { value: void 0 };
     try {
@@ -9931,15 +9927,42 @@ async function bindArrayPattern2(pattern, value, target, scope, context) {
     }
   };
   let retained;
-  const release = retainValues(budget, () => [value, iterator.retainedValue, retained]);
+  let continuation;
+  const release = retainValues(budget, () => [
+    value,
+    iterator.retainedValue,
+    retained,
+    continuation?.current,
+    continuation?.referenceObject,
+    continuation?.referenceKey
+  ]);
   try {
-    for (let index = 0; index < pattern.elements.length; index += 1) {
+    for (let index = saved?.index ?? 0; index < pattern.elements.length; index += 1) {
       const element = pattern.elements[index];
       if (element === null) {
         await next(false);
         continue;
       }
-      const binding = await bindPatternValue(
+      const resuming = saved !== void 0 && index === saved.index;
+      const state = {
+        kind: "array-pattern",
+        phase: "reference",
+        index,
+        done,
+        current: void 0,
+        iterator
+      };
+      if (resuming) Object.assign(state, saved, { iterator });
+      continuation = state;
+      const elementContext = pattern.nodeId === void 0 ? context : context.withPatternState?.(pattern.nodeId, state) ?? context;
+      const binding = resuming && saved.phase === "binding" ? await bindPattern2(
+        element,
+        saved.current,
+        target,
+        scope,
+        elementContext,
+        Object.hasOwn(saved, "referenceObject") ? { object: saved.referenceObject, key: saved.referenceKey } : void 0
+      ) : await bindPatternValue(
         element,
         async () => {
           if (element.type !== "RestElement") return next();
@@ -9953,7 +9976,16 @@ async function bindArrayPattern2(pattern, value, target, scope, context) {
         },
         target,
         scope,
-        context
+        elementContext,
+        (current, reference) => {
+          state.phase = "binding";
+          state.current = current;
+          state.done = done;
+          if (reference !== void 0) {
+            state.referenceObject = reference.object;
+            state.referenceKey = reference.key;
+          }
+        }
       );
       if (!binding.ok) {
         if (!done) {
@@ -15488,19 +15520,26 @@ async function evaluateBinaryExpression(node, context) {
 }
 async function evaluateAssignmentExpression(node, context) {
   if (node.left.type === "ArrayPattern" || node.left.type === "ObjectPattern") {
-    const right = await evaluateNode(node.right, context);
+    const restored2 = context.generatorResume === void 0 || node.nodeId === void 0 ? void 0 : context.restoredGeneratorExpressionStates?.get(node.nodeId);
+    if (restored2 !== void 0 && restored2.kind !== "pattern-source") throw new TypeError("Invalid pattern source continuation.");
+    const right = restored2 === void 0 ? await evaluateNode(node.right, context) : { kind: "normal", hasValue: true, value: restored2.value };
     if (right.kind !== "normal") {
       return right;
     }
-    const binding2 = await bindPattern2(node.left, right.value, { assign: true }, context.scope, createPatternContext(context));
-    if (!binding2.ok) {
-      return binding2.result;
+    if (context.generatorYield !== void 0 && node.nodeId !== void 0) {
+      context = { ...context, generatorExpressionStates: new Map([
+        ...context.generatorExpressionStates ?? [],
+        [node.nodeId, { kind: "pattern-source", value: right.value }]
+      ]) };
+    }
+    const release2 = retainValues(context.budget, () => [right.value]);
+    try {
+      const binding2 = await bindPattern2(node.left, right.value, { assign: true }, context.scope, createPatternContext(context));
+      if (!binding2.ok) return binding2.result;
+      return { kind: "normal", hasValue: true, value: right.value };
+    } finally {
+      release2();
     }
-    return {
-      kind: "normal",
-      hasValue: true,
-      value: right.value
-    };
   }
   if (node.left.type === "MemberExpression") {
     return evaluateMemberAssignmentExpression(node, context);
@@ -15810,8 +15849,10 @@ async function evaluateVariableDeclaration(node, context) {
         continue;
       }
     }
+    const restoredSource = context.generatorResume === void 0 || declarator.nodeId === void 0 ? void 0 : context.restoredGeneratorExpressionStates?.get(declarator.nodeId);
+    if (restoredSource !== void 0 && restoredSource.kind !== "pattern-source") throw new TypeError("Invalid declaration source continuation.");
     const restoredValue = declarator.id.type === "Identifier" ? context.scope.consumeRestoredBinding(declarator.id.name) : { found: false };
-    const value = restoredValue.found && isRestorableBindingValue(restoredValue.value) ? {
+    const value = restoredSource !== void 0 ? { kind: "normal", hasValue: true, value: restoredSource.value } : restoredValue.found && isRestorableBindingValue(restoredValue.value) ? {
       kind: "normal",
       hasValue: true,
       value: restoredValue.value
@@ -15823,15 +15864,25 @@ async function evaluateVariableDeclaration(node, context) {
     if (value.kind !== "normal") {
       return value;
     }
-    const binding = await bindPattern2(
-      declarator.id,
-      value.value,
-      { kind: node.kind },
-      context.scope,
-      createPatternContext(context)
-    );
-    if (!binding.ok) {
-      return binding.result;
+    const bindingContext = context.generatorYield === void 0 || declarator.nodeId === void 0 || declarator.init === void 0 || declarator.id.type === "Identifier" ? context : {
+      ...context,
+      generatorExpressionStates: new Map([
+        ...context.generatorExpressionStates ?? [],
+        [declarator.nodeId, { kind: "pattern-source", value: value.value }]
+      ])
+    };
+    const release = retainValues(context.budget, () => [value.value]);
+    try {
+      const binding = await bindPattern2(
+        declarator.id,
+        value.value,
+        { kind: node.kind },
+        context.scope,
+        createPatternContext(bindingContext)
+      );
+      if (!binding.ok) return binding.result;
+    } finally {
+      release();
     }
   }
   return {
@@ -16116,7 +16167,7 @@ async function evaluateForOfStatement(node, context) {
       }
     });
     if (!resuming || saved.phase === "left") {
-      const binding = await bindForOfLoopVariable(node.left, current, scope, phaseContext("left"));
+      const binding = await bindIterationVariable(node.left, current, scope, phaseContext("left"));
       if (!binding.ok) return binding.result;
     }
     const iterationContext = createLoopIterationContext(phaseContext("body"), scope);
@@ -16211,7 +16262,7 @@ async function evaluateForOfIterator(node, value, context, restoredEntry) {
       });
       let binding;
       try {
-        binding = resuming && saved.phase === "body" ? { ok: true } : await bindForOfLoopVariable(node.left, nextValue, scope, phaseContext("left"));
+        binding = resuming && saved.phase === "body" ? { ok: true } : await bindIterationVariable(node.left, nextValue, scope, phaseContext("left"));
       } catch (error) {
         if (isFatalSandboxError(error) || error instanceof HostCallResumabilityError) throw error;
         await closeIterator(iterator, true);
@@ -16266,22 +16317,23 @@ async function evaluateForInStatement(node, context) {
       continue;
     }
     const scope = resuming ? restored.scope : context.scope.child();
-    if (!resuming) {
-      const binding = await bindForInLoopVariable(node.left, key, scope, context);
-      if (!binding.ok) {
-        context.activeLoopIterations.delete(node.nodeId ?? -1);
-        return binding.result;
-      }
-    }
-    const iterationContext = createLoopIterationContext({
+    const phaseContext = (phase) => ({
       ...context,
       ...context.generatorYield === void 0 || node.nodeId === void 0 ? {} : {
         generatorExpressionStates: new Map([
           ...context.generatorExpressionStates ?? [],
-          [node.nodeId, { kind: "for-in", object: right.value, keys, index, scope }]
+          [node.nodeId, { kind: "for-in", phase, object: right.value, keys, index, scope }]
         ])
       }
-    }, scope);
+    });
+    if (!resuming || restored.phase === "left") {
+      const binding = await bindIterationVariable(node.left, key, scope, phaseContext("left"));
+      if (!binding.ok) {
+        context.activeLoopIterations.delete(node.nodeId ?? -1);
+        return binding.result;
+      }
+    }
+    const iterationContext = createLoopIterationContext(phaseContext("body"), scope);
     emitLoopIterationBreakpoint(node, iterationContext);
     const result = await evaluateNode(node.body, iterationContext);
     if (isMatchingBreak(result, loopLabels(node))) {
@@ -16349,16 +16401,6 @@ function isPlainForInObject(value) {
   const prototype = Object.getPrototypeOf(value);
   return prototype === Object.prototype || prototype === null;
 }
-async function bindForInLoopVariable(left, key, scope, context) {
-  if (left.type === "Identifier") {
-    return bindPattern2(left, key, { assign: true }, scope, createPatternContext(context, scope));
-  }
-  const [declarator] = left.declarations;
-  if (left.declarations.length !== 1 || declarator?.id.type !== "Identifier") {
-    throw new TypeError("for...in keys are strings; destructure inside the body");
-  }
-  return bindPattern2(declarator.id, key, { kind: left.kind }, scope, createPatternContext(context, scope));
-}
 function normalEmptyResult() {
   return { kind: "normal", hasValue: false, value: void 0 };
 }
@@ -16537,7 +16579,7 @@ function loopLabels(node) {
 function hasLoopLabel(labels, target) {
   return Array.isArray(labels) ? labels.includes(target) : labels === target;
 }
-async function bindForOfLoopVariable(left, value, scope, context) {
+async function bindIterationVariable(left, value, scope, context) {
   if (left.type !== "VariableDeclaration") {
     return bindPattern2(left, value, { assign: true }, scope, createPatternContext(context, scope));
   }
@@ -16880,6 +16922,8 @@ function getPropertyValue(target, property, context, receiver = target) {
 function createPatternContext(context, scope = context.scope, evaluate = evaluateNode) {
   const evaluationContext = { ...context, scope };
   return {
+    restoredPatternState: (id) => context.generatorResume === void 0 ? void 0 : context.restoredGeneratorExpressionStates?.get(id),
+    withPatternState: (id, state) => context.generatorYield === void 0 ? createPatternContext(context, scope, evaluate) : createPatternContext({ ...context, generatorExpressionStates: new Map([...context.generatorExpressionStates ?? [], [id, state]]) }, scope, evaluate),
     prepareMemberReference: async (pattern) => {
       let reference;
       const result = await evaluateMemberAccess(pattern, evaluationContext, async (member) => {
@@ -20940,7 +20984,15 @@ function captureGuestHeapNode(value, encode) {
       ...value.state !== "suspended" || origin2.expressionStates === void 0 ? {} : {
         expressionStates: Object.fromEntries([...origin2.expressionStates].map(([id, expression]) => [
           String(id),
-          expression.kind === "binary" ? { kind: "binary", left: encode(expression.left) } : expression.kind === "for-of-array" ? { ...expression, values: encode(expression.values), current: encode(expression.current), scope: encode(expression.scope) } : expression.kind === "for-of-iterator" ? {
+          expression.kind === "binary" ? { kind: "binary", left: encode(expression.left) } : expression.kind === "pattern-source" ? { kind: "pattern-source", value: encode(expression.value) } : expression.kind === "array-pattern" ? {
+            kind: "array-pattern",
+            phase: expression.phase,
+            index: expression.index,
+            done: expression.done,
+            current: encode(expression.current),
+            iterator: mapIteratorSnapshot("kind" in expression.iterator ? expression.iterator : expression.iterator.snapshot?.() ?? { kind: "unsupported" }, encode),
+            ...Object.hasOwn(expression, "referenceObject") ? { referenceObject: encode(expression.referenceObject), referenceKey: encode(expression.referenceKey) } : {}
+          } : expression.kind === "for-of-array" ? { ...expression, values: encode(expression.values), current: encode(expression.current), scope: encode(expression.scope) } : expression.kind === "for-of-iterator" ? {
             ...expression,
             value: encode(expression.value),
             current: encode(expression.current),
@@ -22590,18 +22642,26 @@ function validateGuestHeapNode(raw, heap, maxArrayLength = 4294967295) {
         const expression = record2(raw2);
         if (expression.kind === "binary") {
           fields(expression, ["kind", "left"]);
-        } else if (expression.kind === "for-of-array" || expression.kind === "for-of-iterator") {
-          fields(expression, [
-            "kind",
-            "phase",
-            "current",
-            "index",
-            "scope",
-            ...expression.kind === "for-of-array" ? ["values"] : ["value", "iterator", "async"]
-          ]);
-          if (!["left", "body"].includes(String(expression.phase))) throw new TypeError("Invalid for-of phase.");
+        } else if (expression.kind === "pattern-source") {
+          fields(expression, ["kind", "value"]);
+        } else if (expression.kind === "for-of-array" || expression.kind === "for-of-iterator" || expression.kind === "array-pattern") {
+          if (expression.kind === "array-pattern") {
+            fields(expression, ["kind", "phase", "index", "done", "current", "iterator"], ["referenceObject", "referenceKey"]);
+            if (!["reference", "binding"].includes(String(expression.phase)) || typeof expression.done !== "boolean" || Object.hasOwn(expression, "referenceObject") !== Object.hasOwn(expression, "referenceKey")) throw new TypeError("Invalid array pattern state.");
+            if (Object.hasOwn(expression, "referenceKey") && typeof expression.referenceKey !== "string") reference(expression.referenceKey, ["symbol"]);
+          } else {
+            fields(expression, [
+              "kind",
+              "phase",
+              "current",
+              "index",
+              "scope",
+              ...expression.kind === "for-of-array" ? ["values"] : ["value", "iterator", "async"]
+            ]);
+            if (!["left", "body"].includes(String(expression.phase))) throw new TypeError("Invalid for-of phase.");
+            reference(expression.scope, ["scope-frame"]);
+          }
           integer(expression.index);
-          reference(expression.scope, ["scope-frame"]);
           if (expression.kind === "for-of-array") reference(expression.values, ["array", "guest-array"]);
           else {
             let iterator = record2(expression.iterator);
@@ -22637,10 +22697,11 @@ function validateGuestHeapNode(raw, heap, maxArrayLength = 4294967295) {
                 }
               }
             } else throw new TypeError("Invalid iterator continuation.");
-            if (expression.async !== protocol) throw new TypeError("Invalid for-of iterator protocol.");
+            if ((expression.kind === "array-pattern" ? false : expression.async) !== protocol) throw new TypeError("Invalid iterator protocol.");
           }
         } else if (expression.kind === "for-in") {
-          fields(expression, ["kind", "object", "keys", "index", "scope"]);
+          fields(expression, ["kind", "object", "keys", "index", "scope"], ["phase"]);
+          if (Object.hasOwn(expression, "phase") && !["left", "body"].includes(String(expression.phase))) throw new TypeError("Invalid for-in phase.");
           if (array(expression.keys).some((key) => typeof key !== "string") || integer(expression.index) >= array(expression.keys).length) throw new TypeError("Invalid for-in continuation.");
           reference(expression.scope, ["scope-frame"]);
         } else if (expression.kind === "for") {
@@ -22813,8 +22874,8 @@ function validateGuestFunctionAst(record3, origin) {
         });
         continue;
       }
-      if ((node.type === "ArrayExpression" && key === "elements" || node.type === "TemplateLiteral" && key === "expressions" || (node.type === "CallExpression" || node.type === "NewExpression") && key === "arguments") && typeof node.nodeId === "number" && Array.isArray(value)) {
-        const kind = node.type === "ArrayExpression" ? "array" : node.type === "TemplateLiteral" ? "template" : node.type === "CallExpression" ? "call" : "new";
+      if (((node.type === "ArrayExpression" || node.type === "ArrayPattern") && key === "elements" || node.type === "TemplateLiteral" && key === "expressions" || (node.type === "CallExpression" || node.type === "NewExpression") && key === "arguments") && typeof node.nodeId === "number" && Array.isArray(value)) {
+        const kind = node.type === "ArrayPattern" ? "array-pattern" : node.type === "ArrayExpression" ? "array" : node.type === "TemplateLiteral" ? "template" : node.type === "CallExpression" ? "call" : "new";
         value.forEach((element, index) => pending.push({
           value: element,
           blocks,
@@ -22830,7 +22891,7 @@ function validateGuestFunctionAst(record3, origin) {
       pending.push({
         value,
         blocks,
-        expressions: node.type === "ForOfStatement" && ["left", "body"].includes(key) && typeof node.nodeId === "number" ? new Map([...frame.expressions, [node.nodeId, { kind: "for-of", phase: key, async: node.await === true }]]) : node.type === "ForInStatement" && key === "body" && typeof node.nodeId === "number" ? new Map([...frame.expressions, [node.nodeId, { kind: "for-in" }]]) : node.type === "ForStatement" && ["init", "test", "body", "update"].includes(key) && typeof node.nodeId === "number" ? new Map([...frame.expressions, [node.nodeId, { kind: "for", phase: key }]]) : node.type === "BinaryExpression" && key === "right" && typeof node.nodeId === "number" ? new Map([...frame.expressions, [node.nodeId, { kind: "binary" }]]) : node.type === "AssignmentExpression" && key === "right" && typeof node.nodeId === "number" && node.left.type === "Identifier" ? new Map([...frame.expressions, [node.nodeId, { kind: "identifier-assignment" }]]) : node.type === "AssignmentExpression" && key === "right" && typeof node.nodeId === "number" && node.left.type === "MemberExpression" ? new Map([...frame.expressions, [node.nodeId, {
+        expressions: (node.type === "VariableDeclarator" && key === "id" && node.init !== void 0 || node.type === "AssignmentExpression" && key === "left") && typeof node.nodeId === "number" && ["ArrayPattern", "ObjectPattern"].includes(String(value?.type)) ? new Map([...frame.expressions, [node.nodeId, { kind: "pattern-source" }]]) : node.type === "ForOfStatement" && ["left", "body"].includes(key) && typeof node.nodeId === "number" ? new Map([...frame.expressions, [node.nodeId, { kind: "for-of", phase: key, async: node.await === true }]]) : node.type === "ForInStatement" && ["left", "body"].includes(key) && typeof node.nodeId === "number" ? new Map([...frame.expressions, [node.nodeId, { kind: "for-in", phase: key }]]) : node.type === "ForStatement" && ["init", "test", "body", "update"].includes(key) && typeof node.nodeId === "number" ? new Map([...frame.expressions, [node.nodeId, { kind: "for", phase: key }]]) : node.type === "BinaryExpression" && key === "right" && typeof node.nodeId === "number" ? new Map([...frame.expressions, [node.nodeId, { kind: "binary" }]]) : node.type === "AssignmentExpression" && key === "right" && typeof node.nodeId === "number" && node.left.type === "Identifier" ? new Map([...frame.expressions, [node.nodeId, { kind: "identifier-assignment" }]]) : node.type === "AssignmentExpression" && key === "right" && typeof node.nodeId === "number" && node.left.type === "MemberExpression" ? new Map([...frame.expressions, [node.nodeId, {
           kind: "member-assignment",
           key: node.operator !== "=",
           superReceiver: node.left.object.type === "Super"
@@ -22860,7 +22921,7 @@ function validateGuestFunctionAst(record3, origin) {
   for (const [id, expression] of expressions) {
     const expected = yieldExpressions?.get(Number(id));
     const compatibleKind = expected?.kind === expression.kind || expected?.kind === "for-of" && (expression.kind === "for-of-iterator" || !expected.async && expression.kind === "for-of-array") || expected?.kind === "call" && expected.member === true && expression.kind === "array-call";
-    if (expected === void 0 || !compatibleKind || expected.kind !== "binary" && expected.kind !== "identifier-assignment" && expected.kind !== "member" && expected.kind !== "member-assignment" && expected.kind !== "for" && expected.kind !== "for-in" && expected.kind !== "for-of" && expected.index !== expression.index || (expected.kind === "for" || expected.kind === "for-of") && expected.phase !== expression.phase || expected.kind === "for-of" && expression.kind === "for-of-iterator" && expected.async !== expression.async || expected.kind === "member-assignment" && (expected.key !== Object.hasOwn(expression, "key") || expected.superReceiver !== Object.hasOwn(expression, "superReceiver")) || expected.kind === "member" && expected.superReceiver !== Object.hasOwn(expression, "superReceiver") || expected.kind === "object" && expected.key !== Object.hasOwn(expression, "key"))
+    if (expected === void 0 || !compatibleKind || expected.kind !== "binary" && expected.kind !== "pattern-source" && expected.kind !== "identifier-assignment" && expected.kind !== "member" && expected.kind !== "member-assignment" && expected.kind !== "for" && expected.kind !== "for-in" && expected.kind !== "for-of" && expected.index !== expression.index || (expected.kind === "for" || expected.kind === "for-of") && expected.phase !== expression.phase || expected.kind === "for-in" && expected.phase !== (expression.phase ?? "body") || expected.kind === "for-of" && expression.kind === "for-of-iterator" && expected.async !== expression.async || expected.kind === "member-assignment" && (expected.key !== Object.hasOwn(expression, "key") || expected.superReceiver !== Object.hasOwn(expression, "superReceiver")) || expected.kind === "member" && expected.superReceiver !== Object.hasOwn(expression, "superReceiver") || expected.kind === "object" && expected.key !== Object.hasOwn(expression, "key"))
       throw new TypeError("Invalid generator AST identity: unrelated expression continuation");
   }
 }
@@ -39106,4 +39167,4 @@ export {
   FileSnapshotBackend,
   run
 };
-//# sourceMappingURL=chunk-5SF3QHIJ.js.map
+//# sourceMappingURL=chunk-4EKZGMNU.js.map