hackmud-script-manager 0.19.0-50a29ed → 0.19.0-cd5548c

package/processScript/transform.js

@@ -1 +1,394 @@
-import e from"@babel/traverse";import t from"@babel/types";import{v as i}from"../constants-9bb78688.js";import{getReferencePathsToGlobal as r}from"./shared.js";import{a as n}from"../assert-22a7ef8a.js";function clearObject(e,t){for(const t of Object.getOwnPropertyNames(e))delete e[t];for(const t of Object.getOwnPropertySymbols(e))delete e[t];void 0!==t&&Object.setPrototypeOf(e,t)}const{default:o}=e,a=["Map","Set","Date","JSON","Math","Array","Error","isNaN","Number","Object","RegExp","String","Symbol","BigInt"],transform=(e,s,{uniqueID:p="00000000000",scriptUser:l="UNKNOWN",scriptName:c="UNKNOWN",seclevel:d=4}={})=>{const f=`_${p}_SCRIPT_`,b=new Map,y=new Map;let $;if(o(e,{Program(e){$=e,e.skip()}}),$.scope.hasGlobal("_SOURCE"))for(const e of r("_SOURCE",$))e.replaceWith(t.stringLiteral(s));if($.scope.hasGlobal("_BUILD_DATE"))for(const e of r("_BUILD_DATE",$))e.replaceWith(t.numericLiteral(Date.now()));if($.scope.hasGlobal("_SCRIPT_USER"))for(const e of r("_SCRIPT_USER",$))1==l?e.replaceWith(t.stringLiteral(`$${p}$SCRIPT_USER$`)):e.replaceWith(t.stringLiteral(l));if($.scope.hasGlobal("_SCRIPT_NAME"))for(const e of r("_SCRIPT_NAME",$))1==c?e.replaceWith(t.stringLiteral(`$${p}$SCRIPT_NAME$`)):e.replaceWith(t.stringLiteral(c));if($.scope.hasGlobal("_FULL_SCRIPT_NAME"))for(const e of r("_FULL_SCRIPT_NAME",$))1==l||1==c?e.replaceWith(t.stringLiteral(`$${p}$FULL_SCRIPT_NAME$`)):e.replaceWith(t.stringLiteral(`${l}.${c}`));let m=!1;const createGetFunctionPrototypeNode=()=>{for(const e of a)if(!$.scope.hasOwnBinding(e))return t.memberExpression(t.memberExpression(t.identifier(e),t.identifier("constructor")),t.identifier("prototype"));return t.memberExpression(t.memberExpression(t.arrowFunctionExpression([t.identifier("_")],t.identifier("_")),t.identifier("constructor")),t.identifier("prototype"))};if($.scope.hasGlobal("Function")){const e=r("Function",$);if(1==e.length){const t=e[0];n("MemberExpression"==t.parent.type,"`Function` isn't available in hackmud, only `Function.prototype` is accessible"),n("Identifier"==t.parent.property.type,"`Function` isn't available in hackmud, only `Function.prototype` is accessible"),n("prototype"==t.parent.property.name,"`Function` isn't available in hackmud, only `Function.prototype` is accessible"),t.parentPath.replaceWith(createGetFunctionPrototypeNode())}else{for(const i of e)n("MemberExpression"==i.parent.type,"`Function` isn't available in hackmud, only `Function.prototype` is accessible"),n("Identifier"==i.parent.property.type,"`Function` isn't available in hackmud, only `Function.prototype` is accessible"),n("prototype"==i.parent.property.name,"`Function` isn't available in hackmud, only `Function.prototype` is accessible"),m=!0,i.parentPath.replaceWith(t.identifier(`_${p}_FUNCTION_DOT_PROTOTYPE_`));m=!0}}let h=4;const processFakeSubscriptObject=e=>{for(const a of r(e,$)){var i,o;n("MemberExpression"==a.parent.type),n("Identifier"==a.parent.property.type),n("MemberExpression"==(null===(i=a.parentPath.parentPath)||void 0===i?void 0:i.node.type)),n("Identifier"==a.parentPath.parentPath.node.property.type),n(/^[_a-z][\d_a-z]{0,24}$/.test(a.parent.property.name),`invalid user "${a.parent.property.name}" in subscript`),n(/^[_a-z][\d_a-z]{0,24}$/.test(a.parentPath.parentPath.node.property.name),`invalid script name "${a.parentPath.parentPath.node.property.name}" in subscript`),"CallExpression"==(null===(o=a.parentPath.parentPath.parentPath)||void 0===o?void 0:o.type)?a.parentPath.parentPath.replaceWith(t.identifier(`$${p}$SUBSCRIPT$${a.parent.property.name}$${a.parentPath.parentPath.node.property.name}$`)):a.parentPath.parentPath.replaceWith(t.arrowFunctionExpression([t.restElement(t.identifier("args"))],t.callExpression(t.identifier(`$${p}$SUBSCRIPT$${a.parent.property.name}$${a.parentPath.parentPath.node.property.name}$`),[t.spreadElement(t.identifier("args"))])))}};for(const e of["$fs","$4s","$s"])$.scope.hasGlobal(e)&&processFakeSubscriptObject(e);for(const e of["$hs","$3s"])$.scope.hasGlobal(e)&&(h=3,processFakeSubscriptObject(e));for(const e of["$ms","$2s"])$.scope.hasGlobal(e)&&(h=2,processFakeSubscriptObject(e));for(const e of["$ls","$1s"])$.scope.hasGlobal(e)&&(h=1,processFakeSubscriptObject(e));for(const e of["$ns","$0s"])$.scope.hasGlobal(e)&&(h=0,processFakeSubscriptObject(e));if(d=Math.min(d,h),$.scope.hasGlobal("$db"))for(const e of r("$db",$)){var E;n("MemberExpression"==e.parentPath.node.type),n("Identifier"==e.parentPath.node.property.type);const r=e.parentPath.node.property.name;n(i.includes(r),`invalid db method "${r}", valid db methods are "${i.join('", "')}"`),"CallExpression"==(null===(E=e.parentPath.parentPath)||void 0===E?void 0:E.type)?e.parentPath.replaceWith(t.identifier(`$${p}$DB$${r}$`)):"ObjectId"==r?e.parentPath.replaceWith(t.arrowFunctionExpression([],t.callExpression(t.identifier(`$${p}$DB$${r}$`),[]))):"i"==r||"r"==r?e.parentPath.replaceWith(t.arrowFunctionExpression([t.identifier("a")],t.callExpression(t.identifier(`$${p}$DB$${r}$`),[t.identifier("a")]))):e.parentPath.replaceWith(t.arrowFunctionExpression([t.identifier("a"),t.identifier("b")],t.callExpression(t.identifier(`$${p}$DB$${r}$`),[t.identifier("a"),t.identifier("b")])))}if($.scope.hasGlobal("$D"))for(const e of r("$D",$))"CallExpression"==e.parentPath.type?e.replaceWith(t.identifier(`$${p}$DEBUG$`)):e.replaceWith(t.arrowFunctionExpression([t.identifier("a")],t.callExpression(t.identifier(`$${p}$DEBUG$`),[t.identifier("a")])));if($.scope.hasGlobal("$FMCL"))for(const e of r("$FMCL",$))e.replaceWith(t.identifier(`$${p}$FMCL$`));if($.scope.hasGlobal("$G"))for(const e of r("$G",$))e.replaceWith(t.identifier(`$${p}$GLOBAL$`));if($.scope.hasGlobal("_SECLEVEL"))for(const e of r("_SECLEVEL",$))e.replaceWith(t.numericLiteral(d));let _=!1,u=!1;if($.scope.hasGlobal("Object"))for(const e of r("Object",$))"MemberExpression"!=e.parent.type||e.parent.computed||(n("Identifier"==e.parent.property.type),"getPrototypeOf"==e.parent.property.name?(e.parentPath.replaceWith(t.identifier(`_${p}_GET_PROTOTYPE_OF_`)),_=!0):"setPrototypeOf"==e.parent.property.name&&(e.parentPath.replaceWith(t.identifier(`_${p}_SET_PROTOTYPE_OF_`)),u=!0));const P=$.node.body[$.node.body.length-1];let x;if(n(P,"program is empty"),"ExportNamedDeclaration"==P.type){$.node.body.pop();for(const e of P.specifiers){n("ExportSpecifier"==e.type,`${e.type} is currently unsupported`);const t="Identifier"==e.exported.type?e.exported.name:e.exported.value;"default"==t?x=e.local.name:b.set(e.local.name,t)}}const O=t.blockStatement([]);let D;for(const e of $.node.body)if("VariableDeclaration"==e.type)for(const i of e.declarations)if("Identifier"!=i.id.type||i.id.name!=x||!i.init||"FunctionExpression"!=i.init.type&&"ArrowFunctionExpression"!=i.init.type||i.init.async||i.init.generator){for(const r in t.getBindingIdentifiers(i.id))r==x&&(D=t.functionDeclaration(t.identifier(f),[t.identifier("context"),t.identifier("args")],t.blockStatement([t.returnStatement(t.callExpression(t.identifier(x),[]))]))),"const"!=e.kind&&b.has(r)&&(y.set(r,b.get(r)),b.delete(r)),O.body.push(t.variableDeclaration("let",[t.variableDeclarator(t.identifier(r))]));i.init&&O.body.push(t.expressionStatement(t.assignmentExpression("=",i.id,i.init)))}else D=t.functionDeclaration(t.identifier(f),i.init.params,"BlockStatement"==i.init.body.type?i.init.body:t.blockStatement([t.returnStatement(i.init.body)]));else"FunctionDeclaration"==e.type?e.id.name==x?D=e:O.body.push(t.variableDeclaration("let",[t.variableDeclarator(e.id,t.functionExpression(void 0,e.params,e.body,e.generator,e.async))])):O.body.push(e);if(D||(D=t.functionDeclaration(t.identifier(f),[t.identifier("context"),t.identifier("args")],t.blockStatement([]))),$.node.body=[D],O.body.length){(b.size||y.size)&&D.body.body.push(t.returnStatement(t.objectExpression([...[...b].map((([e,i])=>t.objectProperty(t.identifier(i),t.identifier(e)))),...[...y].map((([e,i])=>t.objectMethod("get",t.identifier(i),[],t.blockStatement([t.returnStatement(t.identifier(e))]))))]))),$.scope.crawl();const e=new Set;let i=0;for(const[r,o]of[...O.body.entries()].reverse())if("VariableDeclaration"==o.type){n(1==o.declarations.length);const a=o.declarations[0];if(n("Identifier"==a.id.type,`declarator.id.type was "${a.id.type}"`),$.scope.crawl(),$.scope.hasGlobal(a.id.name)){O.body.splice(r,1);const[s]=$.unshiftContainer("body",O),[l]=$.unshiftContainer("body",o);if($.scope.crawl(),!a.init||"FunctionExpression"!=a.init.type&&"ArrowFunctionExpression"!=a.init.type||Object.keys($.scope.globals).some((t=>e.has(t)))){const e=$.scope.getBinding(a.id.name);n(e);for(const i of e.referencePaths)n("Identifier"==i.node.type),i.replaceWith(t.memberExpression(t.identifier(`$${p}$GLOBAL$`),t.identifier(i.node.name)));for(const i of e.constantViolations)if("AssignmentExpression"==i.node.type)for(const[e,r]of Object.entries(t.getBindingIdentifiers(i.node)))e==a.id.name&&(clearObject(r),Object.assign(r,t.memberExpression(t.identifier(`$${p}$GLOBAL$`),t.identifier(e))));s.remove(),l.remove(),a.init&&O.body.splice(r,0,t.expressionStatement(t.assignmentExpression("=",t.memberExpression(t.identifier(`$${p}$GLOBAL$`),t.identifier(a.id.name)),a.init)))}else s.remove(),l.remove(),D.body.body.unshift(o),i++}else e.add(a.id.name)}else if("ClassDeclaration"==o.type&&($.scope.crawl(),$.scope.hasGlobal(o.id.name))){O.body.splice(r,1);const[e]=$.unshiftContainer("body",O),[i]=$.unshiftContainer("body",o);$.scope.crawl();const a=$.scope.getBinding(o.id.name);n(a);for(const e of a.referencePaths)n("Identifier"==e.node.type),e.replaceWith(t.memberExpression(t.identifier(`$${p}$GLOBAL$`),t.identifier(e.node.name)));e.remove(),i.remove(),O.body.splice(r,0,t.expressionStatement(t.assignmentExpression("=",t.memberExpression(t.identifier(`$${p}$GLOBAL$`),t.identifier(o.id.name)),t.classExpression(void 0,o.superClass,o.body,o.decorators))))}if($.scope.hasGlobal("_EXPORTS"))for(const e of r("_EXPORTS",$))e.replaceWith(t.arrayExpression([...b.keys(),...y.keys()].map((e=>t.stringLiteral(e)))));O.body.length&&D.body.body.splice(i,0,t.ifStatement(t.unaryExpression("!",t.identifier(`$${p}$FMCL$`)),O))}return m&&D.body.body.unshift(t.variableDeclaration("let",[t.variableDeclarator(t.identifier(`_${p}_FUNCTION_DOT_PROTOTYPE_`),createGetFunctionPrototypeNode())])),u&&D.body.body.unshift(t.variableDeclaration("let",[t.variableDeclarator(t.identifier(`_${p}_SET_PROTOTYPE_OF_`),t.callExpression(t.memberExpression(t.memberExpression(t.identifier("Object"),t.identifier("call")),t.identifier("bind")),[t.identifier(`_${p}_DUNDER_PROTO_SETTER_`)]))])),_&&D.body.body.unshift(t.variableDeclaration("let",[t.variableDeclarator(t.identifier(`_${p}_GET_PROTOTYPE_OF_`),t.callExpression(t.memberExpression(t.memberExpression(t.identifier("Object"),t.identifier("call")),t.identifier("bind")),[t.identifier(`_${p}_DUNDER_PROTO_GETTER_`)]))])),(_||u)&&D.body.body.unshift(t.variableDeclaration("let",[t.variableDeclarator(t.objectPattern(_?u?[t.objectProperty(t.identifier("get"),t.identifier(`_${p}_DUNDER_PROTO_GETTER_`)),t.objectProperty(t.identifier("set"),t.identifier(`_${p}_DUNDER_PROTO_SETTER_`))]:[t.objectProperty(t.identifier("get"),t.identifier(`_${p}_DUNDER_PROTO_GETTER_`))]:[t.objectProperty(t.identifier("set"),t.identifier(`_${p}_DUNDER_PROTO_SETTER_`))]),t.callExpression(t.memberExpression(t.identifier("Object"),t.identifier("getOwnPropertyDescriptor")),[t.memberExpression(t.identifier("Object"),t.identifier("prototype")),t.stringLiteral("__proto__")]))])),o(e,{BlockStatement({node:e}){for(const[i,r]of e.body.entries())"FunctionDeclaration"!=r.type||r.generator||(e.body.splice(i,1),e.body.unshift(t.variableDeclaration("let",[t.variableDeclarator(r.id,t.arrowFunctionExpression(r.params,r.body,r.async))])))},ClassBody({node:e,scope:i,parent:r}){n(t.isClass(r));let a=!1;for(const r of e.body){if("ClassMethod"!=r.type)continue;let e=!1;if(o(r.body,{ThisExpression(i){e=!0,a=!0,i.replaceWith(t.identifier(`_${p}_THIS_`))},Function(e){e.skip()}},i),e)if("constructor"!=r.kind)r.body.body.unshift(t.variableDeclaration("let",[t.variableDeclarator(t.identifier(`_${p}_THIS_`),t.callExpression(t.memberExpression(t.super(),t.identifier("valueOf")),[]))]));else{const e=[];if(o(r.body,{CallExpression(t){"Super"==t.node.callee.type&&e.push(t)}},i),e.length)if(1==e.length&&"ExpressionStatement"==e[0].parent.type&&e[0].parentPath.parentPath.parent==r)e[0].parentPath.replaceWith(t.variableDeclaration("let",[t.variableDeclarator(t.identifier(`_${p}_THIS_`),e[0].node)]));else{for(const i of e)i.replaceWith(t.assignmentExpression("=",t.identifier(`_${p}_THIS_`),i.node));r.body.body.unshift(t.variableDeclaration("let",[t.variableDeclarator(t.identifier(`_${p}_THIS_`))]))}else r.body.body.unshift(t.variableDeclaration("let",[t.variableDeclarator(t.identifier(`_${p}_THIS_`),t.callExpression(t.super(),[]))]))}}!r.superClass&&a&&(r.superClass=t.identifier("Object"))},VariableDeclaration({node:e}){"const"==e.kind&&(e.kind="let")},ThisExpression(e){e.replaceWith(t.identifier("undefined"))},BigIntLiteral(e){const i=Number(e.node.value);BigInt(i)==BigInt(e.node.value)?e.replaceWith(t.callExpression(t.identifier("BigInt"),[t.numericLiteral(i)])):e.replaceWith(t.callExpression(t.identifier("BigInt"),[t.stringLiteral(e.node.value)]))}}),{file:e,seclevel:d}};export{transform as default,transform};
+import babelTraverse from '@babel/traverse';
+import t from '@babel/types';
+import { assert } from '@samual/lib/assert';
+import { clearObject } from '@samual/lib/clearObject';
+import { validDBMethods } from '../constants.js';
+import { getReferencePathsToGlobal } from './shared.js';
+
+// eslint-disable-next-line @typescript-eslint/consistent-type-imports
+const {
+  default: traverse
+} = babelTraverse;
+const globalFunctionsUnder7Characters = [`Map`, `Set`, `Date`, `JSON`, `Math`, `Array`, `Error`, `isNaN`, `Number`, `Object`, `RegExp`, `String`, `Symbol`, `BigInt`];
+
+/**
+ * transform a given babel `File` to be hackmud compatible
+ *
+ * (returned File will need `postprocess()`ing)
+ *
+ * @param file babel ast node representing a file containing preprocessed code
+ * @param sourceCode the original untouched source code
+ * @param options {@link TransformOptions details}
+ */
+const transform = (file, sourceCode, {
+  uniqueID = `00000000000`,
+  scriptUser = `UNKNOWN`,
+  scriptName = `UNKNOWN`,
+  seclevel = 4
+} = {}) => {
+  const topFunctionName = `_${uniqueID}_SCRIPT_`;
+  const exports = new Map();
+  const liveExports = new Map();
+  let program;
+  traverse(file, {
+    Program(path) {
+      program = path;
+      path.skip();
+    }
+  });
+  if (program.scope.hasGlobal(`_SOURCE`)) {
+    for (const referencePath of getReferencePathsToGlobal(`_SOURCE`, program)) referencePath.replaceWith(t.stringLiteral(sourceCode));
+  }
+  if (program.scope.hasGlobal(`_BUILD_DATE`)) {
+    for (const referencePath of getReferencePathsToGlobal(`_BUILD_DATE`, program)) referencePath.replaceWith(t.numericLiteral(Date.now()));
+  }
+  if (program.scope.hasGlobal(`_SCRIPT_USER`)) {
+    for (const referencePath of getReferencePathsToGlobal(`_SCRIPT_USER`, program)) {
+      if (scriptUser == true) referencePath.replaceWith(t.stringLiteral(`$${uniqueID}$SCRIPT_USER$`));else referencePath.replaceWith(t.stringLiteral(scriptUser));
+    }
+  }
+  if (program.scope.hasGlobal(`_SCRIPT_NAME`)) {
+    for (const referencePath of getReferencePathsToGlobal(`_SCRIPT_NAME`, program)) {
+      if (scriptName == true) referencePath.replaceWith(t.stringLiteral(`$${uniqueID}$SCRIPT_NAME$`));else referencePath.replaceWith(t.stringLiteral(scriptName));
+    }
+  }
+  if (program.scope.hasGlobal(`_FULL_SCRIPT_NAME`)) {
+    for (const referencePath of getReferencePathsToGlobal(`_FULL_SCRIPT_NAME`, program)) {
+      if (scriptUser == true || scriptName == true) referencePath.replaceWith(t.stringLiteral(`$${uniqueID}$FULL_SCRIPT_NAME$`));else referencePath.replaceWith(t.stringLiteral(`${scriptUser}.${scriptName}`));
+    }
+  }
+  let functionDotPrototypeIsReferencedMultipleTimes = false;
+  const createGetFunctionPrototypeNode = () => {
+    for (const globalFunction of globalFunctionsUnder7Characters) {
+      if (program.scope.hasOwnBinding(globalFunction)) continue;
+      return t.memberExpression(t.memberExpression(t.identifier(globalFunction), t.identifier(`constructor`)), t.identifier(`prototype`));
+    }
+    return t.memberExpression(t.memberExpression(t.arrowFunctionExpression([t.identifier(`_`)], t.identifier(`_`)), t.identifier(`constructor`)), t.identifier(`prototype`));
+  };
+  if (program.scope.hasGlobal(`Function`)) {
+    const FunctionReferencePaths = getReferencePathsToGlobal(`Function`, program);
+    if (FunctionReferencePaths.length == 1) {
+      const referencePath = FunctionReferencePaths[0];
+      assert(referencePath.parent.type == `MemberExpression`, `\`Function\` isn't available in hackmud, only \`Function.prototype\` is accessible`);
+      assert(referencePath.parent.property.type == `Identifier`, `\`Function\` isn't available in hackmud, only \`Function.prototype\` is accessible`);
+      assert(referencePath.parent.property.name == `prototype`, `\`Function\` isn't available in hackmud, only \`Function.prototype\` is accessible`);
+      referencePath.parentPath.replaceWith(createGetFunctionPrototypeNode());
+    } else {
+      for (const referencePath of FunctionReferencePaths) {
+        assert(referencePath.parent.type == `MemberExpression`, `\`Function\` isn't available in hackmud, only \`Function.prototype\` is accessible`);
+        assert(referencePath.parent.property.type == `Identifier`, `\`Function\` isn't available in hackmud, only \`Function.prototype\` is accessible`);
+        assert(referencePath.parent.property.name == `prototype`, `\`Function\` isn't available in hackmud, only \`Function.prototype\` is accessible`);
+        functionDotPrototypeIsReferencedMultipleTimes = true;
+        referencePath.parentPath.replaceWith(t.identifier(`_${uniqueID}_FUNCTION_DOT_PROTOTYPE_`));
+      }
+      functionDotPrototypeIsReferencedMultipleTimes = true;
+    }
+  }
+  let detectedSeclevel = 4;
+  const processFakeSubscriptObject = fakeSubscriptObjectName => {
+    for (const referencePath of getReferencePathsToGlobal(fakeSubscriptObjectName, program)) {
+      var _referencePath$parent, _referencePath$parent2;
+      assert(referencePath.parent.type == `MemberExpression`);
+      assert(referencePath.parent.property.type == `Identifier`);
+      assert(((_referencePath$parent = referencePath.parentPath.parentPath) === null || _referencePath$parent === void 0 ? void 0 : _referencePath$parent.node.type) == `MemberExpression`);
+      assert(referencePath.parentPath.parentPath.node.property.type == `Identifier`);
+      assert(/^[_a-z][\d_a-z]{0,24}$/.test(referencePath.parent.property.name), `invalid user "${referencePath.parent.property.name}" in subscript`);
+      assert(/^[_a-z][\d_a-z]{0,24}$/.test(referencePath.parentPath.parentPath.node.property.name), `invalid script name "${referencePath.parentPath.parentPath.node.property.name}" in subscript`);
+      if (((_referencePath$parent2 = referencePath.parentPath.parentPath.parentPath) === null || _referencePath$parent2 === void 0 ? void 0 : _referencePath$parent2.type) == `CallExpression`) {
+        // BUG this is causing typescript to be slow
+        referencePath.parentPath.parentPath.replaceWith(t.identifier(`$${uniqueID}$SUBSCRIPT$${referencePath.parent.property.name}$${referencePath.parentPath.parentPath.node.property.name}$`));
+      } else {
+        // BUG this is causing typescript to be slow
+        referencePath.parentPath.parentPath.replaceWith(t.arrowFunctionExpression([t.restElement(t.identifier(`args`))], t.callExpression(t.identifier(`$${uniqueID}$SUBSCRIPT$${referencePath.parent.property.name}$${referencePath.parentPath.parentPath.node.property.name}$`), [t.spreadElement(t.identifier(`args`))])));
+      }
+    }
+  };
+  for (const fakeSubscriptObjectName of [`$fs`, `$4s`, `$s`]) {
+    if (program.scope.hasGlobal(fakeSubscriptObjectName)) processFakeSubscriptObject(fakeSubscriptObjectName);
+  }
+  for (const fakeSubscriptObjectName of [`$hs`, `$3s`]) {
+    if (program.scope.hasGlobal(fakeSubscriptObjectName)) {
+      detectedSeclevel = 3;
+      processFakeSubscriptObject(fakeSubscriptObjectName);
+    }
+  }
+  for (const fakeSubscriptObjectName of [`$ms`, `$2s`]) {
+    if (program.scope.hasGlobal(fakeSubscriptObjectName)) {
+      detectedSeclevel = 2;
+      processFakeSubscriptObject(fakeSubscriptObjectName);
+    }
+  }
+  for (const fakeSubscriptObjectName of [`$ls`, `$1s`]) {
+    if (program.scope.hasGlobal(fakeSubscriptObjectName)) {
+      detectedSeclevel = 1;
+      processFakeSubscriptObject(fakeSubscriptObjectName);
+    }
+  }
+  for (const fakeSubscriptObjectName of [`$ns`, `$0s`]) {
+    if (program.scope.hasGlobal(fakeSubscriptObjectName)) {
+      detectedSeclevel = 0;
+      processFakeSubscriptObject(fakeSubscriptObjectName);
+    }
+  }
+  seclevel = Math.min(seclevel, detectedSeclevel);
+  if (program.scope.hasGlobal(`$db`)) {
+    for (const referencePath of getReferencePathsToGlobal(`$db`, program)) {
+      var _referencePath$parent3;
+      assert(referencePath.parentPath.node.type == `MemberExpression`);
+      assert(referencePath.parentPath.node.property.type == `Identifier`);
+      const databaseOpMethodName = referencePath.parentPath.node.property.name;
+      assert(validDBMethods.includes(databaseOpMethodName), `invalid db method "${databaseOpMethodName}", valid db methods are "${validDBMethods.join(`", "`)}"`);
+      if (((_referencePath$parent3 = referencePath.parentPath.parentPath) === null || _referencePath$parent3 === void 0 ? void 0 : _referencePath$parent3.type) == `CallExpression`) referencePath.parentPath.replaceWith(t.identifier(`$${uniqueID}$DB$${databaseOpMethodName}$`));else if (databaseOpMethodName == `ObjectId`) {
+        referencePath.parentPath.replaceWith(t.arrowFunctionExpression([], t.callExpression(t.identifier(`$${uniqueID}$DB$${databaseOpMethodName}$`), [])));
+      } else if (databaseOpMethodName == `i` || databaseOpMethodName == `r`) {
+        referencePath.parentPath.replaceWith(t.arrowFunctionExpression([t.identifier(`a`)], t.callExpression(t.identifier(`$${uniqueID}$DB$${databaseOpMethodName}$`), [t.identifier(`a`)])));
+      } else {
+        referencePath.parentPath.replaceWith(t.arrowFunctionExpression([t.identifier(`a`), t.identifier(`b`)], t.callExpression(t.identifier(`$${uniqueID}$DB$${databaseOpMethodName}$`), [t.identifier(`a`), t.identifier(`b`)])));
+      }
+    }
+  }
+  if (program.scope.hasGlobal(`$D`)) {
+    for (const referencePath of getReferencePathsToGlobal(`$D`, program)) {
+      if (referencePath.parentPath.type == `CallExpression`) referencePath.replaceWith(t.identifier(`$${uniqueID}$DEBUG$`));else {
+        referencePath.replaceWith(t.arrowFunctionExpression([t.identifier(`a`)], t.callExpression(t.identifier(`$${uniqueID}$DEBUG$`), [t.identifier(`a`)])));
+      }
+    }
+  }
+  if (program.scope.hasGlobal(`$FMCL`)) {
+    for (const referencePath of getReferencePathsToGlobal(`$FMCL`, program)) referencePath.replaceWith(t.identifier(`$${uniqueID}$FMCL$`));
+  }
+  if (program.scope.hasGlobal(`$G`)) {
+    for (const referencePath of getReferencePathsToGlobal(`$G`, program)) referencePath.replaceWith(t.identifier(`$${uniqueID}$GLOBAL$`));
+  }
+  if (program.scope.hasGlobal(`_SECLEVEL`)) {
+    for (const referencePath of getReferencePathsToGlobal(`_SECLEVEL`, program)) referencePath.replaceWith(t.numericLiteral(seclevel));
+  }
+  let needGetPrototypeOf = false;
+  let needSetPrototypeOf = false;
+  if (program.scope.hasGlobal(`Object`)) {
+    for (const referencePath of getReferencePathsToGlobal(`Object`, program)) {
+      if (referencePath.parent.type != `MemberExpression` || referencePath.parent.computed) continue;
+      assert(referencePath.parent.property.type == `Identifier`);
+      if (referencePath.parent.property.name == `getPrototypeOf`) {
+        referencePath.parentPath.replaceWith(t.identifier(`_${uniqueID}_GET_PROTOTYPE_OF_`));
+        needGetPrototypeOf = true;
+      } else if (referencePath.parent.property.name == `setPrototypeOf`) {
+        referencePath.parentPath.replaceWith(t.identifier(`_${uniqueID}_SET_PROTOTYPE_OF_`));
+        needSetPrototypeOf = true;
+      }
+    }
+  }
+
+  // rollup removes all the inline exports and places a statement at the end instead
+  const lastStatement = program.node.body.at(-1);
+  let exportDefaultName;
+  assert(lastStatement, `program is empty`);
+  if (lastStatement.type == `ExportNamedDeclaration`) {
+    program.node.body.pop();
+    for (const specifier of lastStatement.specifiers) {
+      assert(specifier.type == `ExportSpecifier`, `${specifier.type} is currently unsupported`);
+      const exportedName = specifier.exported.type == `Identifier` ? specifier.exported.name : specifier.exported.value;
+      if (exportedName == `default`) exportDefaultName = specifier.local.name;else exports.set(specifier.local.name, exportedName);
+    }
+  }
+  const globalBlock = t.blockStatement([]);
+  let mainFunction;
+  for (const statement of program.node.body) {
+    if (statement.type == `VariableDeclaration`) {
+      for (const declarator of statement.declarations) {
+        if (declarator.id.type == `Identifier` && declarator.id.name == exportDefaultName && declarator.init && (declarator.init.type == `FunctionExpression` || declarator.init.type == `ArrowFunctionExpression`) && !declarator.init.async && !declarator.init.generator) {
+          mainFunction = t.functionDeclaration(t.identifier(topFunctionName), declarator.init.params, declarator.init.body.type == `BlockStatement` ? declarator.init.body : t.blockStatement([t.returnStatement(declarator.init.body)]));
+          continue;
+        }
+        for (const identifierName in t.getBindingIdentifiers(declarator.id)) {
+          if (identifierName == exportDefaultName) {
+            mainFunction = t.functionDeclaration(t.identifier(topFunctionName), [t.identifier(`context`), t.identifier(`args`)], t.blockStatement([t.returnStatement(t.callExpression(t.identifier(exportDefaultName), []))]));
+          }
+          if (statement.kind != `const` && exports.has(identifierName)) {
+            liveExports.set(identifierName, exports.get(identifierName));
+            exports.delete(identifierName);
+          }
+          globalBlock.body.push(t.variableDeclaration(`let`, [t.variableDeclarator(t.identifier(identifierName))]));
+        }
+        if (declarator.init) {
+          globalBlock.body.push(t.expressionStatement(t.assignmentExpression(`=`, declarator.id, declarator.init)));
+        }
+      }
+    } else if (statement.type == `FunctionDeclaration`) {
+      if (statement.id.name == exportDefaultName) mainFunction = statement;else {
+        globalBlock.body.push(t.variableDeclaration(`let`, [t.variableDeclarator(statement.id, t.functionExpression(undefined, statement.params, statement.body, statement.generator, statement.async))]));
+      }
+    } else globalBlock.body.push(statement);
+  }
+  mainFunction || (mainFunction = t.functionDeclaration(t.identifier(topFunctionName), [t.identifier(`context`), t.identifier(`args`)], t.blockStatement([])));
+  program.node.body = [mainFunction];
+  if (globalBlock.body.length) {
+    if (exports.size || liveExports.size) {
+      mainFunction.body.body.push(t.returnStatement(t.objectExpression([...[...exports].map(([local, exported]) => t.objectProperty(t.identifier(exported), t.identifier(local))), ...[...liveExports].map(([local, exported]) => t.objectMethod(`get`, t.identifier(exported), [], t.blockStatement([t.returnStatement(t.identifier(local))])))])));
+    }
+    program.scope.crawl();
+    const globalBlockVariables = new Set();
+    let hoistedGlobalBlockFunctions = 0;
+    for (const [globalBlockIndex, globalBlockStatement] of [...globalBlock.body.entries()].reverse()) {
+      if (globalBlockStatement.type == `VariableDeclaration`) {
+        assert(globalBlockStatement.declarations.length == 1);
+        const declarator = globalBlockStatement.declarations[0];
+        assert(declarator.id.type == `Identifier`, `declarator.id.type was "${declarator.id.type}"`);
+        program.scope.crawl();
+        if (program.scope.hasGlobal(declarator.id.name)) {
+          globalBlock.body.splice(globalBlockIndex, 1);
+          const [globalBlockPath] = program.unshiftContainer(`body`, globalBlock);
+          const [globalBlockStatementPath] = program.unshiftContainer(`body`, globalBlockStatement);
+          program.scope.crawl();
+          if (!declarator.init || declarator.init.type != `FunctionExpression` && declarator.init.type != `ArrowFunctionExpression` || Object.keys(program.scope.globals).some(global => globalBlockVariables.has(global))) {
+            const binding = program.scope.getBinding(declarator.id.name);
+            assert(binding);
+            for (const referencePath of binding.referencePaths) {
+              assert(referencePath.node.type == `Identifier`);
+              referencePath.replaceWith(t.memberExpression(t.identifier(`$${uniqueID}$GLOBAL$`), t.identifier(referencePath.node.name)));
+            }
+            for (const referencePath of binding.constantViolations) {
+              if (referencePath.node.type != `AssignmentExpression`) continue;
+              for (const [name, node] of Object.entries(t.getBindingIdentifiers(referencePath.node))) {
+                if (name == declarator.id.name) {
+                  clearObject(node);
+                  Object.assign(node, t.memberExpression(t.identifier(`$${uniqueID}$GLOBAL$`), t.identifier(name)));
+                }
+              }
+            }
+            globalBlockPath.remove();
+            globalBlockStatementPath.remove();
+            if (declarator.init) {
+              globalBlock.body.splice(globalBlockIndex, 0, t.expressionStatement(t.assignmentExpression(`=`, t.memberExpression(t.identifier(`$${uniqueID}$GLOBAL$`), t.identifier(declarator.id.name)), declarator.init)));
+            }
+          } else {
+            globalBlockPath.remove();
+            globalBlockStatementPath.remove();
+            mainFunction.body.body.unshift(globalBlockStatement);
+            hoistedGlobalBlockFunctions++;
+          }
+        } else globalBlockVariables.add(declarator.id.name);
+      } else if (globalBlockStatement.type == `ClassDeclaration`) {
+        program.scope.crawl();
+        if (program.scope.hasGlobal(globalBlockStatement.id.name)) {
+          globalBlock.body.splice(globalBlockIndex, 1);
+          const [globalBlockPath] = program.unshiftContainer(`body`, globalBlock);
+          const [globalBlockStatementPath] = program.unshiftContainer(`body`, globalBlockStatement);
+          program.scope.crawl();
+          const binding = program.scope.getBinding(globalBlockStatement.id.name);
+          assert(binding);
+          for (const referencePath of binding.referencePaths) {
+            assert(referencePath.node.type == `Identifier`);
+            referencePath.replaceWith(t.memberExpression(t.identifier(`$${uniqueID}$GLOBAL$`), t.identifier(referencePath.node.name)));
+          }
+          globalBlockPath.remove();
+          globalBlockStatementPath.remove();
+          globalBlock.body.splice(globalBlockIndex, 0, t.expressionStatement(t.assignmentExpression(`=`, t.memberExpression(t.identifier(`$${uniqueID}$GLOBAL$`), t.identifier(globalBlockStatement.id.name)), t.classExpression(undefined, globalBlockStatement.superClass, globalBlockStatement.body, globalBlockStatement.decorators))));
+        }
+      }
+    }
+    if (program.scope.hasGlobal(`_EXPORTS`)) {
+      for (const referencePath of getReferencePathsToGlobal(`_EXPORTS`, program)) {
+        referencePath.replaceWith(t.arrayExpression([...exports.keys(), ...liveExports.keys()].map(name => t.stringLiteral(name))));
+      }
+    }
+    if (globalBlock.body.length) {
+      mainFunction.body.body.splice(hoistedGlobalBlockFunctions, 0, t.ifStatement(t.unaryExpression(`!`, t.identifier(`$${uniqueID}$FMCL$`)), globalBlock));
+    }
+  }
+  if (functionDotPrototypeIsReferencedMultipleTimes) {
+    mainFunction.body.body.unshift(t.variableDeclaration(`let`, [t.variableDeclarator(t.identifier(`_${uniqueID}_FUNCTION_DOT_PROTOTYPE_`), createGetFunctionPrototypeNode())]));
+  }
+  if (needSetPrototypeOf) {
+    mainFunction.body.body.unshift(t.variableDeclaration(`let`, [t.variableDeclarator(t.identifier(`_${uniqueID}_SET_PROTOTYPE_OF_`), t.callExpression(t.memberExpression(t.memberExpression(t.identifier(`Object`), t.identifier(`call`)), t.identifier(`bind`)), [t.identifier(`_${uniqueID}_DUNDER_PROTO_SETTER_`)]))]));
+  }
+  if (needGetPrototypeOf) {
+    mainFunction.body.body.unshift(t.variableDeclaration(`let`, [t.variableDeclarator(t.identifier(`_${uniqueID}_GET_PROTOTYPE_OF_`), t.callExpression(t.memberExpression(t.memberExpression(t.identifier(`Object`), t.identifier(`call`)), t.identifier(`bind`)), [t.identifier(`_${uniqueID}_DUNDER_PROTO_GETTER_`)]))]));
+  }
+  if (needGetPrototypeOf || needSetPrototypeOf) {
+    mainFunction.body.body.unshift(t.variableDeclaration(`let`, [t.variableDeclarator(t.objectPattern(needGetPrototypeOf ? needSetPrototypeOf ? [t.objectProperty(t.identifier(`get`), t.identifier(`_${uniqueID}_DUNDER_PROTO_GETTER_`)), t.objectProperty(t.identifier(`set`), t.identifier(`_${uniqueID}_DUNDER_PROTO_SETTER_`))] : [t.objectProperty(t.identifier(`get`), t.identifier(`_${uniqueID}_DUNDER_PROTO_GETTER_`))] : [t.objectProperty(t.identifier(`set`), t.identifier(`_${uniqueID}_DUNDER_PROTO_SETTER_`))]), t.callExpression(t.memberExpression(t.identifier(`Object`), t.identifier(`getOwnPropertyDescriptor`)), [t.memberExpression(t.identifier(`Object`), t.identifier(`prototype`)), t.stringLiteral(`__proto__`)]))]));
+  }
+  traverse(file, {
+    BlockStatement({
+      node: blockStatement
+    }) {
+      for (const [index, functionDeclaration] of blockStatement.body.entries()) {
+        if (functionDeclaration.type != `FunctionDeclaration` || functionDeclaration.generator) continue;
+        blockStatement.body.splice(index, 1);
+        blockStatement.body.unshift(t.variableDeclaration(`let`, [t.variableDeclarator(functionDeclaration.id, t.arrowFunctionExpression(functionDeclaration.params, functionDeclaration.body, functionDeclaration.async))]));
+      }
+    },
+    ClassBody({
+      node: classBody,
+      scope,
+      parent
+    }) {
+      assert(t.isClass(parent));
+      let thisIsReferenced = false;
+      for (const classMethod of classBody.body) {
+        if (classMethod.type != `ClassMethod`) continue;
+        let methodReferencesThis = false;
+        traverse(classMethod.body, {
+          ThisExpression(path) {
+            methodReferencesThis = true;
+            thisIsReferenced = true;
+            path.replaceWith(t.identifier(`_${uniqueID}_THIS_`));
+          },
+          Function(path) {
+            path.skip();
+          }
+        }, scope);
+        if (!methodReferencesThis) continue;
+        if (classMethod.kind == `constructor`) {
+          const superCalls = [];
+          traverse(classMethod.body, {
+            CallExpression(path) {
+              if (path.node.callee.type == `Super`) superCalls.push(path);
+            }
+          }, scope);
+          if (!superCalls.length) {
+            classMethod.body.body.unshift(t.variableDeclaration(`let`, [t.variableDeclarator(t.identifier(`_${uniqueID}_THIS_`), t.callExpression(t.super(), []))]));
+          } else if (superCalls.length == 1 && superCalls[0].parent.type == `ExpressionStatement` && superCalls[0].parentPath.parentPath.parent == classMethod) {
+            superCalls[0].parentPath.replaceWith(t.variableDeclaration(`let`, [t.variableDeclarator(t.identifier(`_${uniqueID}_THIS_`), superCalls[0].node)]));
+          } else {
+            for (const path of superCalls) {
+              path.replaceWith(t.assignmentExpression(`=`, t.identifier(`_${uniqueID}_THIS_`), path.node));
+            }
+            classMethod.body.body.unshift(t.variableDeclaration(`let`, [t.variableDeclarator(t.identifier(`_${uniqueID}_THIS_`))]));
+          }
+          continue;
+        }
+
+        // BUG if the class or a super class overwrites `valueOf()` (or `Object.prototype` isn't even in the chain), this breaks
+        // TODO track whether the class is extending a class that at some point extends from `Object` (if unsure, assume no)
+        // TODO track whether any class in the chain overwrites `valueOf()` (if unsure, assume yes)
+        // TODO for classes that need it, create a super class for this one to extend from with `valueOf()` assigned to an unused name
+
+        classMethod.body.body.unshift(t.variableDeclaration(`let`, [t.variableDeclarator(t.identifier(`_${uniqueID}_THIS_`), t.callExpression(t.memberExpression(t.super(), t.identifier(`valueOf`)), []))]));
+      }
+      if (!parent.superClass && thisIsReferenced) parent.superClass = t.identifier(`Object`);
+    },
+    VariableDeclaration({
+      node: variableDeclaration
+    }) {
+      if (variableDeclaration.kind == `const`) variableDeclaration.kind = `let`;
+    },
+    ThisExpression(path) {
+      path.replaceWith(t.identifier(`undefined`));
+    },
+    BigIntLiteral(path) {
+      const bigIntAsNumber = Number(path.node.value);
+      if (BigInt(bigIntAsNumber) == BigInt(path.node.value)) {
+        path.replaceWith(t.callExpression(t.identifier(`BigInt`), [t.numericLiteral(bigIntAsNumber)]));
+      } else {
+        path.replaceWith(t.callExpression(t.identifier(`BigInt`), [t.stringLiteral(path.node.value)]));
+      }
+    }
+  });
+  return {
+    file,
+    seclevel
+  };
+};
+
+export { transform as default, transform };

package/pull.js

@@ -1 +1,17 @@
-import{dirname as t,resolve as r}from"path";import s from"fs";const{mkdir:i,copyFile:o}=s.promises;const pull=async(s,e,a)=>{const[c,n]=a.split(".");if(!c||!n)throw new Error('`script` argument must be in "user.name" format');await function copyFilePersistent(r,s,e){return o(r,s,e).catch((async a=>{if("ENOENT"!=a.code)throw a;await i(t(s),{recursive:!0}),await o(r,s,e)}))}(r(e,c,"scripts",`${n}.js`),r(s,c,`${n}.js`))};export{pull as default,pull};
+import { copyFilePersistent } from '@samual/lib/copyFilePersistent';
+import { resolve } from 'path';
+
+/**
+ * Copies script from hackmud to local source folder.
+ *
+ * @param sourceFolderPath path to folder containing source files
+ * @param hackmudPath path to hackmud directory
+ * @param script to pull in `user.name` format
+ */
+const pull = async (sourceFolderPath, hackmudPath, script) => {
+  const [user, name] = script.split(`.`);
+  if (!user || !name) throw new Error(`\`script\` argument must be in "user.name" format`);
+  await copyFilePersistent(resolve(hackmudPath, user, `scripts`, `${name}.js`), resolve(sourceFolderPath, user, `${name}.js`));
+};
+
+export { pull as default, pull };

package/push.d.ts

@@ -1,6 +1,6 @@
-import { LaxPartial } from "@samual/lib";
-import { Info } from ".";
-export declare type PushOptions = {
+import type { LaxPartial } from "@samual/lib";
+import type { Info } from ".";
+export type PushOptions = {
     /** whether to do the minify step (defaults to `true`) */
     minify: boolean;
     /** whether to mangle function and class names (defaults to `false`) */