Function classifyEffect

src/ui-server/api/effects.ts:296–335

(input: EffectInput)

 * everything else — a plain call into a library is not an effect.
 */
export function classifyEffect(input: EffectInput): Effect | null {
  // Rules see the chain without its argument lists: `res.status(404).json`
  // is `res.status.json`, `ResponseEntity.status(HttpStatus.NOT_FOUND).body`
  // is `ResponseEntity.status.body`.
  const text = normaliseCall(input.text).replace(/\([^()]*\)/g, '');
  if (text === '') return null;
  const families = familiesOf(input.language);
  const project = input.project ?? 'app';
  if (families.includes('swift') && SWIFT_NOT_AN_EFFECT.test(text)) return null;

  for (const rule of EFFECT_RULES) {
    if (input.projectType && rule.category !== 'database' && rule.category !== 'response') continue;
    if (rule.only && !rule.only.some((f) => families.includes(f))) {
      // An ungated language (no family) still gets the JS rows — the table
      // grew up on them and the old tests call with no language.
      if (input.language) continue;
      if (!rule.only.includes('js')) continue;
    }
    if (rule.instantiates && input.kind !== 'instantiates') continue;
    if (rule.test.test(text)) return withShape(rule.category, text, input.args ?? null, input.language ?? null, null);
  }

  // The receiver's declared type — a library's, never a class of the project
  // (the caller checks): `OwnerRepository owners` makes `owners.save` the
  // database when no row above knew the name.
  if (input.receiverType) {
    const type = input.receiverType.replace(/^(?:readonly|private|public|protected|final|static)\s+/g, '').trim();
    for (const rule of RECEIVER_TYPE_RULES) {
      if (rule.test.test(type)) return withShape(rule.category, text, input.args ?? null, input.language ?? null, type);
    }
  }

  // A thrown web exception is a response, in a project that has endpoints.
  if (project !== 'app' && (input.kind === 'instantiates' || families.includes('py') || families.includes('swift'))) {
    // `\\InvalidArgumentException`, `Foo\\BarException`: the class, not its namespace.
    const last = (text.split(/[.:]/).pop() ?? text).replace(/^.*\\/, '');
    if (EXCEPTION_RESPONSE.test(text) && !NOT_A_RESPONSE.test(last)) return { category: 'response' };
  }
  return null;
}

const READ_OPS =
  /^(?:find\w*|findone|get|getone|getmany|getall\w*|getbyid\w*|getasync|list\w*|count\w*|aggregate|select\w*|query\w*|queryrow\w*|scalar\w*|first\w*|single\w*|last\w*|all|any\w*|exists\w*|tolist\w*|toarray\w*|filter|where|fetch\w*|load\w*|read\w*|scan|search|paginate|pluck|distinct|group\w*|order\w*|include\w*|join\w*|objects|values|values_list|iterator|stream|max|min|sum|avg|average|exists\?|one|one_or_none|scalars?|find_by|find_each|firstordefault\w*|singleordefault\w*|countdocuments|rows|row|preload|take|limit|offset|skip|raw|fromsql\w*|\$queryraw|get_or_404|get_object_or_404|describe\w*|head\w*|retrieve|show|index|lookup|peek|contains|has|check|isempty|is_empty|size|length|fetchone|fetchall|fetchmany|refresh)$/i;