Skip to content

armgit / rea

Public Imported from GitHub
0

Reverse engineer anything with agents, from app behavior down to native binaries.

27.8 KB
Raw Blame
import { expect, it } from "vitest";

import { analyzeJavaScriptSemantics } from "./javascriptSemanticAnalysis.js";

it("shares required process writes with globals while keeping earlier observations", () => {
  const ir = analyzeJavaScriptSemantics(`const proc=require('process');
    process.cwd(); const before=proc.env.BEFORE;
    proc.env={}; const after=process.env.AFTER;`);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["BEFORE"]);
});

it("does not propagate replacement-object writes from import-equals direct origins", () => {
  const ir = analyzeJavaScriptSemantics(`import fs = require('fs');
    const other=require('fs'); fs={}; fs.readFileSync=custom; other.readFileSync('kept');`);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
});

it("retains original import-equals aliases captured before reassignment", () => {
  const ir = analyzeJavaScriptSemantics(`import fs = require('fs');
    const alias=fs; const other=require('fs'); fs={}; alias.readFileSync=custom; other.readFileSync('wrong');`);
  expect(ir.configurationOperations).toEqual([]);
});

it("keeps computed namespace calls as unknown receiver escapes", () => {
  const ir = analyzeJavaScriptSemantics(
    `const fs=require('fs'); fs.hook=custom; fs[key](); fs.readFileSync('wrong');`,
  );
  expect(ir.configurationOperations).toEqual([]);
});

it.each(["(0, fs.readFileSync)", "(assigned = fs.readFileSync)"])(
  "checks captured function validity through %s",
  (value) => {
    const ir = analyzeJavaScriptSemantics(`const fs=require('fs'); let assigned;
    const saved=${value}; fs.readFileSync=custom; const late=${value}; saved('kept'); late('wrong');`);
    expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
  },
);

it.each(['process.env={MODE:"local"};', "process.argv=[];", "patch(process);"])(
  "shares unbound process object effects with required aliases: %s",
  (write) => {
    const ir =
      analyzeJavaScriptSemantics(`${write} const proc=require('process');
    ${write.includes("argv") ? "const arg=proc.argv[2];" : "const mode=proc.env.MODE;"}`);
    expect(ir.configurationOperations).toEqual([]);
  },
);

it.each([
  "function local(process) {process.env={};}",
  "process={}; process.env={};",
])("keeps unrelated process replacements separate: %s", (write) => {
  const ir = analyzeJavaScriptSemantics(
    `${write} const proc=require('process'); const mode=proc.env.MODE;`,
  );
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["MODE"]);
});

it("preserves exports captured before a later loader overwrite", () => {
  const ir = analyzeJavaScriptSemantics(`
    const fs=require('node:fs'); fs.readFileSync('before');
    const read=fs.readFileSync;
    require('fs').readFileSync('direct-before');
    require=replacement;
    fs.readFileSync('after'); read('saved');
    const late=require('fs'); late.readFileSync('wrong');
    require('fs').readFileSync('also-wrong');
  `);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual([
    "before",
    "direct-before",
    "after",
    "saved",
  ]);
});

it.each([
  `for (;;) { require('fs').readFileSync('wrong'); require=replacement; }`,
  `function run() { require('fs').readFileSync('wrong'); require=replacement; }`,
  `require=replacement; const fs=require('fs'); fs.readFileSync('wrong'); require=again;`,
])(
  "keeps repeated or already replaced loader captures uncertain: %s",
  (source) => {
    expect(analyzeJavaScriptSemantics(source).configurationOperations).toEqual(
      [],
    );
  },
);

it.each([
  ["fs.readFileSync = custom;", "other.readFileSync('wrong');"],
  ["other.readFileSync = custom;", "fs.readFileSync('wrong');"],
  ["patch(fs);", "other.readFileSync('wrong');"],
])(
  "shares require-mode import-equals effects in both directions: %s",
  (write, call) => {
    const ir = analyzeJavaScriptSemantics(`import fs = require('node:fs');
    const other = require('fs'); other.readFileSync('before'); ${write} ${call}`);
    expect(ir.configurationOperations.map(({ key }) => key)).toEqual([
      "before",
    ]);
  },
);

it.each([
  "import {readFileSync as read} from 'node:fs';",
  "const {readFileSync:read}=require('node:fs');",
  "const fs=require('fs'); const read=fs.readFileSync;",
])(
  "retains captured native function calls after argument escape: %s",
  (capture) => {
    const ir = analyzeJavaScriptSemantics(
      `${capture} observe(read); read('kept');`,
    );
    expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
  },
);

it("distinguishes escaping a method value from escaping its namespace", () => {
  const ir = analyzeJavaScriptSemantics(`const fs=require('fs');
    observe(fs.readFileSync); fs.readFileSync('kept');
    observe(fs); fs.readFileSync('wrong');`);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
});

it("still invalidates escaped process configuration containers", () => {
  const ir = analyzeJavaScriptSemantics(`const proc=require('process');
    observe(proc.env); const mode=proc.env.MODE;`);
  expect(ir.configurationOperations).toEqual([]);
});

it("retains direct require effects without poisoning later cached receivers", () => {
  const ir = analyzeJavaScriptSemantics(`
    require('node:fs').readFileSync('first');
    const fs = require('fs'); fs.readFileSync('second');
    require('node:fs').createReadStream('stream');
    require('node:child_process').spawn('tool', []);
    require('node:timers').setTimeout(callback, 1);
    require('node:http').get('http://example.test');
    require('fs').readFileSync = custom;
    require('node:fs').readFileSync('wrong'); fs.readFileSync('wrong');
  `);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual([
    "first",
    "second",
  ]);
  expect(ir.resourceOperations).toHaveLength(1);
  expect(ir.childProcessSpawns).toHaveLength(1);
  expect(ir.timerOperations).toHaveLength(1);
  expect(ir.requestOperations).toHaveLength(1);
});

it.each([
  "const fs = require('fs'); fs.promises.open = custom;",
  "require('node:fs').promises.open = custom;",
  "const fsp = require('fs/promises'); fsp.open = custom;",
])("shares fs.promises object writes with fs/promises: %s", (write) => {
  const ir = analyzeJavaScriptSemantics(`
    const before = require('node:fs/promises'); before.open('before');
    ${write}
    const after = require('node:fs/promises'); after.open('wrong');
  `);
  expect(ir.resourceOperations).toHaveLength(1);
});

it.each([
  "require = () => ({ readFileSync() {} });",
  "({ loader: require } = other);",
  "for (require of loaders) {}",
])("rejects provenance from an overwritten ambient loader: %s", (write) => {
  const ir = analyzeJavaScriptSemantics(`${write}
    const fs = require('node:fs'); fs.readFileSync('wrong');
    require('node:fs').readFileSync('also-wrong');
  `);
  expect(ir.configurationOperations).toEqual([]);
  expect(
    ir.bindings.find(({ name }) => name === "fs")?.provenance.status,
  ).not.toBe("module");
});

it("keeps local loader reassignment separate from the ambient loader", () => {
  const ir = analyzeJavaScriptSemantics(`
    function local(require) { require = replacement; }
    const fs = require('node:fs'); fs.readFileSync('kept');
  `);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
});

it("keeps wrapper require separate from global-object property writes", () => {
  const ir = analyzeJavaScriptSemantics(`
    globalThis.require = replacement;
    function polyfill(key) { globalThis[key] = replacement; }
    require('node:fs').readFileSync('kept');
  `);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
});

it.each(["import fs from 'node:fs';", "const fs = require('node:fs');"])(
  "retains reads and saved methods before a later write: %s",
  (declaration) => {
    const ir = analyzeJavaScriptSemantics(`${declaration}
      fs.readFileSync('before');
      const saved = fs.readFileSync;
      const { readFileSync: destructured } = fs;
      const namespace = fs;
      fs.readFileSync = custom;
      saved('saved'); destructured('destructured');
      namespace.readFileSync('wrong'); fs.readFileSync('wrong');
    `);
    expect(ir.configurationOperations.map(({ key }) => key)).toEqual([
      "before",
      "saved",
      "destructured",
    ]);
  },
);

it.each([
  "const { readFileSync: read } = require('fs');",
  "const read = require('fs').readFileSync;",
])("checks cached module writes at the projected capture: %s", (capture) => {
  const ir = analyzeJavaScriptSemantics(`
    const fs = require('node:fs');
    const saved = require('fs').readFileSync;
    fs.readFileSync = custom;
    ${capture}
    read('wrong'); saved('saved');
  `);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["saved"]);
});

it("retains captured methods across later escapes without freezing a namespace alias", () => {
  const ir = analyzeJavaScriptSemantics(`
    const fs = require('node:fs'); const saved = require('fs').readFileSync;
    const namespace = require('fs'); patch(fs);
    const late = require('fs').readFileSync;
    saved('saved'); late('wrong'); namespace.readFileSync('wrong');
  `);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["saved"]);
});

it("keeps writes in repeated callable and loop activations conservative", () => {
  const ir = analyzeJavaScriptSemantics(`
    const fs = require('node:fs');
    function run() { fs.readFileSync('wrong'); fs.readFileSync = custom; }
    for (;;) { const read = require('fs').readFileSync; read('wrong'); fs.readFileSync = custom; }
  `);
  expect(ir.configurationOperations).toEqual([]);
});

it("does not propagate a reassigned local object's writes into cached exports", () => {
  const ir = analyzeJavaScriptSemantics(
    `let a = require('node:fs'); const b = require('node:fs'); a = {}; a.readFileSync = custom; b.readFileSync('kept');`,
  );
  expect(ir.configurationOperations).toMatchObject([{ key: "kept" }]);
});

it("shares repeated require mutations for every built-in effect family", () => {
  const ir = analyzeJavaScriptSemantics(`
    const fs = require('fs'); const otherFs = require('node:fs'); fs.createReadStream = custom; otherFs.createReadStream('wrong');
    const cp = require('child_process'); const otherCp = require('node:child_process'); cp.spawn = custom; otherCp.spawn('wrong', []);
    const timers = require('timers'); const otherTimers = require('node:timers'); timers.setTimeout = custom; otherTimers.setTimeout(callback, 1);
    const http = require('http'); const otherHttp = require('node:http'); http.get = custom; otherHttp.get('http://wrong.test');
    const proc = require('process'); const otherProc = require('node:process'); proc.env = replacement; const mode = otherProc.env.MODE;
  `);
  expect(ir.configurationOperations).toEqual([]);
  expect(ir.resourceOperations).toEqual([]);
  expect(ir.childProcessSpawns).toEqual([]);
  expect(ir.timerOperations).toEqual([]);
  expect(ir.requestOperations).toEqual([]);
});

it.each(["node:fs", "fs"])(
  "shares repeated built-in require identity across %s",
  (specifier) => {
    const ir = analyzeJavaScriptSemantics(
      `const a = require('node:fs'); const b = require('${specifier}'); const alias = b; a.readFileSync = custom; b.createReadStream('kept'); alias.readFileSync('wrong');`,
    );
    expect(ir.configurationOperations).toEqual([]);
    expect(ir.resourceOperations).toMatchObject([
      { method: "createReadStream" },
    ]);
  },
);

it("shares unknown escapes across repeated requires without losing earlier effects", () => {
  const ir = analyzeJavaScriptSemantics(
    `const a = require('node:fs'); const b = require('fs'); b.readFileSync('before'); patch(a); b.readFileSync('after');`,
  );
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["before"]);
});

it("preserves exact default ESM import mutation paths", () => {
  const ir = analyzeJavaScriptSemantics(
    `import fs from 'node:fs'; fs.writeFileSync = custom; fs.readFileSync('kept'); fs.writeFileSync('replaced');`,
  );
  expect(ir.configurationOperations).toMatchObject([
    { kind: "file", key: "kept" },
  ]);
});

it("retains built-in effects before later top-level escapes", () => {
  const ir = analyzeJavaScriptSemantics(`
    const fs = require('node:fs'); const cp = require('node:child_process'); const timers = require('node:timers'); const http = require('node:http');
    fs.readFileSync('before'); fs.createReadStream('before'); cp.spawn('tool', []); timers.setTimeout(callback, 1); http.get('http://example.test');
    patch(fs); patch(cp); patch(timers); patch(http);
    fs.readFileSync('after'); fs.createReadStream('after'); cp.spawn('wrong', []); timers.setTimeout(callback, 1); http.get('http://wrong.test');
  `);
  expect(ir.configurationOperations).toMatchObject([{ key: "before" }]);
  expect(ir.resourceOperations).toHaveLength(1);
  expect(ir.childProcessSpawns).toMatchObject([{ command: "tool" }]);
  expect(ir.timerOperations).toHaveLength(1);
  expect(ir.requestOperations).toMatchObject([
    { endpoint: "http://example.test" },
  ]);
});

it.each(["env", "argv"])(
  "does not treat a replaced process %s as configuration",
  (family) => {
    const ir = analyzeJavaScriptSemantics(
      `const proc = require('node:process'); proc.${family} = replacement; const value = proc.${family}[${family === "env" ? "'MODE'" : "2"}];`,
    );
    expect(ir.configurationOperations).toEqual([]);
  },
);

it("does not infer temporal safety across repeated callable or loop activations", () => {
  const ir = analyzeJavaScriptSemantics(
    `const fs = require('node:fs'); function run() { fs.readFileSync('callable'); patch(fs); } for (;;) { fs.readFileSync('loop'); patch(fs); }`,
  );
  expect(ir.configurationOperations).toEqual([]);
});

it("does not recover a replaced method through a subsequent alias", () => {
  const ir = analyzeJavaScriptSemantics(
    `const fs = require('node:fs'); fs.readFileSync = custom; const read = fs.readFileSync; read('config.json');`,
  );
  expect(ir.configurationOperations).toEqual([]);
});

it.each([
  "fs.readFileSync = custom; fs.createReadStream = custom; cp.spawn = custom; timers.setTimeout = custom; http.get = custom;",
  "patch(fs); patch(cp); patch(timers); patch(http);",
  "const fsAlias = fs; fsAlias.readFileSync = custom; fsAlias.createReadStream = custom; const cpAlias = cp; cpAlias.spawn = custom; timers[key] = custom; delete http.get;",
])("excludes replaced or escaped CommonJS methods: %s", (mutation) => {
  const ir = analyzeJavaScriptSemantics(`
    const fs = require('node:fs'); const cp = require('node:child_process');
    const timers = require('node:timers'); const http = require('node:http');
    ${mutation}
    fs.readFileSync('config.json'); fs.createReadStream('config.json');
    cp.spawn('tool', []); timers.setTimeout(callback, 1); http.get('http://example.test');
  `);
  expect(ir.configurationOperations).toEqual([]);
  expect(ir.resourceOperations).toEqual([]);
  expect(ir.childProcessSpawns).toEqual([]);
  expect(ir.timerOperations).toEqual([]);
  expect(ir.requestOperations).toEqual([]);
});

it("preserves unaffected CommonJS methods after sibling property mutation", () => {
  const ir = analyzeJavaScriptSemantics(
    `const fs = require('node:fs'); fs.writeFileSync = custom; fs.readFileSync('config.json');`,
  );
  expect(ir.configurationOperations).toMatchObject([
    { kind: "file", key: "config.json" },
  ]);
});

it.each([
  `const fs = require("node:fs"); const cp = require("node:child_process");
   const timers = require("node:timers"); const http = require("node:http");
   const read = fs.readFileSync; const launch = cp.spawn;
   const schedule = timers.setTimeout; const get = http.get;`,
  `const fs = require("fs"); const { readFileSync: read } = fs;
   const { spawn: launch } = require("child_process");
   const { setTimeout: schedule } = require("timers");
   const { get } = require("http");`,
])("recovers builtin effects from CommonJS provenance: %s", (declarations) => {
  const ir = analyzeJavaScriptSemantics(`${declarations}
    const text = read("config.json", "utf8");
    const stream = fs.createReadStream("config.json"); stream.destroy();
    const child = launch("tool", []); child.kill("SIGTERM");
    const timer = schedule(callback, 10); clearTimeout(timer);
    get("http://example.test");
  `);
  expect(ir.configurationOperations).toMatchObject([
    { kind: "file", key: "config.json" },
  ]);
  expect(
    ir.resourceOperations.map(({ kind, method }) => ({ kind, method })),
  ).toEqual([
    { kind: "acquire", method: "createReadStream" },
    { kind: "release", method: "destroy" },
  ]);
  expect(ir.childProcessSpawns).toMatchObject([
    { method: "spawn", command: "tool" },
  ]);
  expect(ir.childProcessInteractions).toMatchObject([
    { kind: "signal", signalName: "SIGTERM" },
  ]);
  expect(
    ir.timerOperations.map(({ kind, method }) => ({ kind, method })),
  ).toEqual([
    { kind: "schedule", method: "setTimeout" },
    { kind: "cancel", method: "clearTimeout" },
  ]);
  expect(ir.requestOperations).toMatchObject([
    { method: "get", endpoint: "http://example.test" },
  ]);
});

it("does not promote ambiguous or non-namespace CommonJS origins to builtin effects", () => {
  const ir = analyzeJavaScriptSemantics(`
    const fake = require("./fs.js"); fake.readFileSync("external");
    const absentDefault = require("node:fs").default; absentDefault.readFileSync("default");
    const { constants } = require("node:fs"); constants.createReadStream("nested");
    let replaced = require("node:fs"); replaced = other; replaced.readFileSync("replaced");
    const mixed = condition ? require("node:fs") : other; mixed.readFileSync("mixed");
    function shadowed(require) { const fs = require("node:fs"); fs.readFileSync("shadowed"); }
  `);
  expect(ir.configurationOperations).toEqual([]);
  expect(ir.resourceOperations).toEqual([]);
});

it("does not assign built-in APIs to unrelated or shadowed bindings", () => {
  const ir = analyzeJavaScriptSemantics(`
    import fs from "./fs.js";
    import { constants as constantsFs } from "node:fs";
    fs.createReadStream("config.json");
    constantsFs.createReadStream("config.json");
    function run(fs) { fs.createReadStream("config.json"); }
  `);

  expect(ir.resourceOperations).toEqual([]);
});

it.each([
  `const fs = require('fs'); class Reader { text = fs.readFileSync('wrong'); } fs.readFileSync = custom; new Reader();`,
  `const fs = require('fs'); class Reader { #text = fs.readFileSync('wrong'); } fs.readFileSync = custom; new Reader();`,
  `const fs = require('fs'); fs.__defineGetter__('readFileSync', () => custom); fs.readFileSync('wrong');`,
  `import proc from 'node:process'; proc.env = {}; const value = process.env.MODE;`,
  `import fs from 'node:fs'; fs.readFileSync = custom; const other = require('fs'); other.readFileSync('wrong');`,
])("keeps delayed or replaced built-in identities unknown: %s", (source) => {
  expect(analyzeJavaScriptSemantics(source).configurationOperations).toEqual(
    [],
  );
});

it.each([
  `const fs = require('fs'); const before = fs.readFileSync('kept'), patch = (fs.readFileSync = custom);`,
  `globalThis.process = {env: {}}; process.env = {}; const proc = require('process'); const value = proc.env.kept;`,
  `import fs from 'node:fs'; fs.writeFileSync = custom; const other = require('fs'); other.readFileSync('kept');`,
])("keeps earlier and independent built-in observations: %s", (source) => {
  expect(
    analyzeJavaScriptSemantics(source).configurationOperations.map(
      ({ key }) => key,
    ),
  ).toEqual(["kept"]);
});

it("shares equivalent alias subproblems and repeated intact receiver facts", () => {
  const aliases = Array.from({ length: 30 }, (_, index) => {
    const previous = index === 0 ? "fs" : `a${index - 1}`;
    return `const a${index} = flag ? ${previous} : ${previous};`;
  });
  const calls = Array.from(
    { length: 128 },
    (_, index) => `a29.readFileSync('file-${index}');`,
  );
  const ir = analyzeJavaScriptSemantics(
    ["const fs = require('fs');", ...aliases, ...calls].join("\n"),
  );
  expect(ir.configurationOperations).toHaveLength(128);
});

it.each([
  `import tls from 'node:tls'; const socket = tls.connect(443, 'example.test'); socket.end();`,
  `import * as tls from 'node:tls'; const socket = tls.connect(443, 'example.test'); socket.end();`,
  `const tls = require('tls'); const socket = tls.connect(443, 'example.test'); socket.end();`,
])("retains TLS acquisitions and their release: %s", (source) => {
  expect(
    analyzeJavaScriptSemantics(source).resourceOperations.map(
      ({ kind, method }) => ({ kind, method }),
    ),
  ).toEqual([
    { kind: "acquire", method: "connect" },
    { kind: "release", method: "end" },
  ]);
});

it.each([
  `globalThis.process.env = {}; const proc = require('process'); const value = proc.env.MODE;`,
  `const host = globalThis; host.process.env = {}; const proc = require('process'); const value = proc.env.MODE;`,
  `import * as procNs from 'node:process'; procNs.default.env = {}; const value = process.env.MODE;`,
  `globalThis.process.env = { MODE: 'local' }; const proc = require('process'); const value = proc.env.MODE;`,
  `const proc = require('process'); proc.env.MODE = 'local'; const value = proc.env.MODE;`,
])("shares writes through the original process object: %s", (source) => {
  expect(analyzeJavaScriptSemantics(source).configurationOperations).toEqual(
    [],
  );
});

it.each([
  [
    `const fs = require('fs'); const result = (fs.readFileSync('kept'), fs.readFileSync = custom);`,
    "kept",
  ],
  [
    `const fs = require('fs'); const read = fs.readFileSync; const result = (read('kept'), fs.readFileSync = custom);`,
    "kept",
  ],
  [
    `const fs = require('fs'); consume(fs.readFileSync('before'), fs.readFileSync = custom);`,
    "before",
  ],
])(
  "retains reads before a later sequence operand: %s",
  (source, expectedKey) => {
    expect(
      analyzeJavaScriptSemantics(source).configurationOperations.map(
        ({ key }) => key,
      ),
    ).toEqual([expectedKey]);
  },
);

it("does not use source offsets for destructuring assignment evaluation order", () => {
  const ir =
    analyzeJavaScriptSemantics(`const fs = require('fs'); const target = {};
    [target[fs.readFileSync('wrong')]] = (fs.readFileSync = custom, []);`);
  expect(ir.configurationOperations).toEqual([]);
});

it("keeps process reads after an alias is reassigned away from the global", () => {
  const ir =
    analyzeJavaScriptSemantics(`let host = globalThis; host = {process: {env: {}}};
    host.process.env = {}; const proc = require('process'); const value = proc.env.MODE;`);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["MODE"]);
});

it("rejects CommonJS require after the wrapper module replaces its delegate", () => {
  const ir =
    analyzeJavaScriptSemantics(`module.require = () => ({ readFileSync() {} });
    const fs = require('node:fs'); fs.readFileSync('unknown');`);
  expect(ir.configurationOperations).toEqual([]);
});

it.each([
  `module.require.extra = true; const fs = require('fs'); fs.readFileSync('kept');`,
  `const owner = module; owner.require = () => ({}); const fs = require('fs'); fs.readFileSync('wrong');`,
  `Object.defineProperty(module, 'require', {value: () => ({})}); const fs = require('fs'); fs.readFileSync('wrong');`,
])("tracks only actual wrapper require replacements: %s", (source) => {
  const ir = analyzeJavaScriptSemantics(source);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(
    source.includes("extra") ? ["kept"] : [],
  );
});

it("preserves a saved promises object after deleting its parent export", () => {
  const ir =
    analyzeJavaScriptSemantics(`const fs = require('fs'); const fsp = fs.promises;
    delete fs.promises; const handle = fsp.open('kept'); handle.close();`);
  expect(
    ir.resourceOperations.map(({ kind, method }) => ({ kind, method })),
  ).toEqual([
    { kind: "acquire", method: "open" },
    { kind: "release", method: "close" },
  ]);
});

it("does not infer network acquisition methods from another built-in", () => {
  const ir = analyzeJavaScriptSemantics(
    `const { open } = require('node:net'); open();`,
  );
  expect(ir.resourceOperations).toEqual([]);
});

it("recognizes nested ESM namespace receivers as original built-ins", () => {
  const ir =
    analyzeJavaScriptSemantics(`import * as ns from 'node:fs'; import fs from 'node:fs';
    ns.default.readFileSync('first'); fs.readFileSync('second');`);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual([
    "first",
    "second",
  ]);
});

it("keeps intact fs/promises identity after deleting the fs.promises slot", () => {
  const ir =
    analyzeJavaScriptSemantics(`const fs=require('fs'); delete fs.promises;
    const fsp=require('fs/promises'); const handle=fsp.open('kept'); handle.close();`);
  expect(
    ir.resourceOperations.map(({ kind, method }) => ({ kind, method })),
  ).toEqual([
    { kind: "acquire", method: "open" },
    { kind: "release", method: "close" },
  ]);
});

it.each([
  `import fs from 'node:fs'; fs.promises = { open() {} }; fs.promises.open('wrong');`,
  `const fs = require('fs'); patch(fs.promises); require('fs/promises').open('wrong');`,
  `const fs = require('fs'); patch(fs.promises); require('node:fs/promises').open('wrong');`,
])("keeps replaced or escaped promises receivers unknown: %s", (source) => {
  expect(analyzeJavaScriptSemantics(source).resourceOperations).toEqual([]);
});

it("follows final sequence expressions for direct built-in method calls", () => {
  const ir = analyzeJavaScriptSemantics(`const fs = require('fs');
    (0, fs.readFileSync)('kept'); fs.readFileSync = custom;
    (0, fs.readFileSync)('wrong');`);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
});

it.each([
  `import { env } from 'node:process'; patch(env); process.env.MODE;`,
  `import { argv } from 'node:process'; patch(argv); process.argv[2];`,
])(
  "shares named process containers with their namespace aliases: %s",
  (source) => {
    expect(analyzeJavaScriptSemantics(source).configurationOperations).toEqual(
      [],
    );
  },
);

it("retains uncertainty after a computed write to module's require delegate", () => {
  const ir =
    analyzeJavaScriptSemantics(`const key = 'require'; module[key] = replacement;
    const fs = require('fs'); fs.readFileSync('wrong');`);
  expect(ir.configurationOperations).toEqual([]);
});

it("retains a module namespace captured before its binding is reassigned", () => {
  const ir =
    analyzeJavaScriptSemantics(`let fs = require('fs'); const saved = fs;
    fs = {}; saved.readFileSync('kept');`);
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
});

it("does not let own fs probe calls hide later builtin reads", () => {
  const ir = analyzeJavaScriptSemantics(
    `const fs=require('fs'); fs.existsSync('probe'); fs.readFileSync('kept');`,
  );
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
});

it("resolves nested ESM default namespace methods", () => {
  const ir = analyzeJavaScriptSemantics(
    `import * as ns from 'node:fs'; ns.default.readFileSync('kept');`,
  );
  expect(ir.configurationOperations.map(({ key }) => key)).toEqual(["kept"]);
});

it("tracks process objects passed through qualified global references", () => {
  const ir =
    analyzeJavaScriptSemantics(`patch(globalThis.process); const proc = require('process');
    const mode = proc.env.MODE;`);
  expect(ir.configurationOperations).toEqual([]);
});

it("checks a saved child object's method when that function is selected", () => {
  const ir =
    analyzeJavaScriptSemantics(`const fs = require('fs'); const fsp = fs.promises;
    fs.promises.open = custom; const open = fsp.open; open('wrong');`);
  expect(ir.resourceOperations).toEqual([]);
});

it("retains an earlier captured function after its object method is replaced", () => {
  const ir =
    analyzeJavaScriptSemantics(`const fs = require('fs'); const fsp = fs.promises;
    const open = fsp.open; fs.promises.open = custom; open('kept');`);
  expect(ir.resourceOperations).toMatchObject([
    { kind: "acquire", method: "open" },
  ]);
});