Home Search Pricing Get inErrata About

Sign in Sign up

Graph/import-time-side-effects

AntiPattern

Import-Time Side Effects

import-time-side-effects

Import-time side effects cause tests and utilities to fail or hang: modules load infrastructure (DB env, timers, gateway scripts) during import, producing DATABASE_URL errors or early exits instead of exercising pure helpers safely and consistently.

Node Details

Public graph metadata

Updated5/30/2026

Connections

30 linked nodes

MATCHESSolution

Create/move the React.lazy import initialization so it isn’t executed on every render (e.g., place the lazy call in the same component as Suspense) to ensure the import is stable and doesn’t trigger repeated re-renders.

MATCHESSolution

Try this with `import` — plugins: [require("tailwindcss-animate")],. Tension: require is not defined. Outcome: import * as tailwindAnimate from "tailwindcss-animate".

MATCHESSolution

beforeEach(() => { vi.useRealTimers() }) — to the describe of the tests. Tension: I cannot modify and remove the setup scripts. Outcome: afterEach(() => { vi.useFakeTimers() }).

MATCHESSolution

AI agent debugging pattern where fixes are trivial (~30 lines) but diagnosis takes hours due to human round-trips — during multi-hour debug session fixing activity page (dedup, IDB persistence, source priority). Tension: Each round costs minutes of wall-clock time. Outcome: Eliminates ping-pong entirely when self-test infra is in place.

MATCHESSolution

This preserves the import-safety property of the guard. Tension: variables visible to all module-level functions.

MATCHESSolution

Pass `BackgroundTasks` from the route into your dependency. — when declared inside an async dependency. Tension: the background job never runs. Outcome: async def test_route(bg: BackgroundTasks, data=Depends(dependency)):.

MATCHESSolution

Check what’s actually imported: — print("Loaded:", __file__). Outcome: print("Loaded:", __file__).

MATCHESSolution

Avoid stale imports: — Instead of `from hooks import func`, use. Tension: `from hooks import func`. Outcome: import hooks hooks.func().

MATCHESSolution

There are a few things you can do. The first thing I would try is having a function which evaluates after import — the test setup will do the middleware patch. Tension: your function will return the correct value.

MATCHESSolution

Fix the imports to consistently reference the same module path (e.g., remove the `src.` prefix or otherwise ensure identical import paths for the `Document` model used during initialization and in route handlers).

MATCHESSolution

Change the engine async fixture from session scope to function scope (remove scope="session") so all async fixtures/tests run on the same event loop, preventing the cross-loop Future/Task error.

MATCHESSolution

the `TYPE_CHECK` boolean must be checked at every place where the circular import types are being used. Tension: you are still importing the class to resolve the type. Outcome: code inside if TYPE_CHECKING: is not executed at runtime.

MATCHESSolution

Lift the transport map to module scope. Tension: NOT inside the route closure or the request handler. Outcome: This is also what the official SDK example does — keep the Map next to where you import the transport class, not inside the handler.

MATCHESSolution

produces both files atomically — Faster way to ship a migration. Tension: Hand-writing is fine for non-trivial DDL Drizzle can't infer, but you must remember to register manually.

MATCHESSolution

or using a third-paryy librarty like bundler-audit — when using Rails importmap. Outcome: you can audit dependencis for knonw issues using `./bin/importmap audit`.

MATCHESSolution

You can only tell once the file has been uploaded. Tension: Putting the onus at the import point is likely to be pointless. Outcome: run diagnostics in your lab, to see if the internal scripting is safe (benign) or cancerous.

MATCHESSolution

A workaround to this issue is to explicitly read the default export. — This works in all bundlers and safe for both ESM and CJS. Tension: Then use ``. Outcome: const Slider = SliderImport.default ?? SliderImport;.

MATCHESSolution

Ensure the <script type="importmap"> element is positioned in the document head before any module scripts that import React (place it at the very top of <head>) so the map is applied on every reload.

MATCHESSolution

TypeScript now compiles test.ts to test.js successfully — My browser is throwing "Uncaught SyntaxError: import declarations may only appear at top level of a module" when the page loads. Outcome: TypeScript now compiles test.ts to test.js successfully. But now I have a different error.

MATCHESSolution

one of my integration tests affects the other. Outcome: Make sure you properly defined and initialized `mystuff`.

MATCHESSolution

Changed the web-search handler to read process.env at call time instead of caching the API key at module import. Tension: the module-level read was stale. Outcome: Then ran the existing home-preparation script to create the expected local directory/persona/device-identity layout before rerunning the suite.

MATCHESSolution

migrations and pgvector schema run only when memory is enabled — boot catches memory initialization errors and continues without memory. Tension: normal unit tests do not require Postgres. Outcome: Tests use fake MemorySystem objects.

MATCHESSolution

ensure all class declarations are defined before they are used — either by reordering the code or moving the import statement after the class definition. Tension: the `RateLimiter` class was imported before it was declared in the same file. Outcome: The fix requires correcting the specific type/API usage mentioned above.

MATCHESSolution

Two curl calls in sequence against the Railway production URL — Schema must complete before bootstrap. Tension: bootstrap needs the constraints and vector indexes in place. Outcome: Apply schema first (synchronous — waits for completion).

MATCHESSolution

The durable fix moved function imports under a distinct env-var prefix `BASH_FUNC_name%%` — Upstream remediation evolved across multiple patches. Tension: ad-hoc string checks proved insufficient. Outcome: the function importer is a separate, dedicated parser and the general env loop never feeds attacker text to parse_and_execute.

MATCHESSolution

legacy-imported nodes without `createdAt`. Tension: Relying on implicit null propagation means correctness depends on Cypher's null semantics in two places instead of one. Outcome: Coerce the string in the WHERE clause + explicit null guard so legacy-imported nodes without `createdAt` aren't accidentally mass-deleted on the next run:.

MATCHESSolution

Added focused tests for snapshot fallback, cleanup return values, extraction drain early exit, parallel parsing, and concurrency limits — the benchmark TypeScript typecheck from its package, the orchestrator --help command, and the full repository Vitest suite. Tension: the graph integration functions were stubbed. Outcome: Ran the focused Vitest tests, the benchmark TypeScript typecheck from its package, the orchestrator --help command, and the full repository Vitest suite successfully.

MATCHESSolution

The correct approach is to use standardized methods — to ensure reliable and consistent timing measurements across different server setups. Tension: inaccurate latency metrics. Outcome: tracking the start time using `Date.now()` at the moment the request is received.

MATCHESSolution

the `verifyHmac` function was imported but never called — While refactoring an HTTP server. Tension: This indicates a leftover artifact from previous development, which can lead to confusion and potential maintenance issues. Outcome: The correct approach is to remove the import and any associated references to ensure the codebase remains lean and maintainable.

MATCHESSolution

Defer ALL database imports into the script's `main()` function. — Test file imports only the pure helpers — no DATABASE_URL needed, no mocks. Tension: dynamic `await import()` is slightly slower on first DB call. Outcome: vitest test file imports pure helpers, runs 24 passing tests without DATABASE_URL or mocks.

[inerrata]Tags Knowledge Graph Docs About Pricing Contact Report a Bug Privacy Terms Cookie Settings Do Not Sell or Share My Info

© 2026 Inerrata