🔧 update: make sqlite runtime loading safe for node-targeted bundles

[Copilot]

Node-targeted CLIs consuming @wgtechlabs/config-engine could still fail at runtime because bundled output retained a bun:sqlite import. This change keeps Bun as the primary runtime while making the package safe to load from Node-targeted artifacts.

• Runtime adapter loading

  • Replace the static Bun SQLite import path with runtime-only resolution.
  • Keep Node on better-sqlite3 via the existing adapter path.
  • Preserve the Bun-first behavior without leaking bun:* imports into Node bundles.

• Bundling regression coverage

  • Add a focused runtime test that bundles a small entrypoint for target: "node".
  • Assert the emitted bundle does not contain a static bun:sqlite import and can be loaded by Node.

• Documentation

  • Clarify that the Bun SQLite backend is loaded only at runtime on Bun, so Node-targeted bundles can consume the package safely.

import { createRequire } from "node:module";

const runtimeRequire = createRequire(import.meta.url);

function openBunDatabase(filepath: string) {
	const { Database } = runtimeRequire(getBunSqliteSpecifier());
	return new Database(filepath);
}

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Node-targeted npm CLIs fail because the package imports bun:sqlite</issue_title>
<issue_description>## Summary
Using @wgtechlabs/config-engine in a package that is built for Node and published to npm can fail at runtime because the package imports bun:sqlite.

In practice this makes the package Bun-only for bundled Node CLI releases, even when the consumer application itself targets Node.

Repro

Consumer build:

bun build src/index.ts --outfile dist/index.js --target node
node dist/index.js --version

Actual result

Node fails during module loading with:

Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. Received protocol 'bun:'

Why this matters

I hit this in a released npm CLI because Bun bundled the dependency graph into a Node-targeted artifact, and the resulting build still contained bun:sqlite imports.

That means the package is not currently safe to consume from a published Node CLI unless the consumer is also effectively Bun-only.

Expected result

One of these should happen:

1. The package provides a Node-safe backend or conditional runtime adapter.
2. The package clearly documents that it is Bun-only.
3. The package exposes a storage abstraction that allows Node consumers to avoid bundling bun:* imports.

Notes

I am happy to help test a fix from the consumer side.
</issue_description>

<agent_instructions>Let's add support to both node and bun, but primarily we support bun.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Node-targeted npm CLIs fail because the package imports bun:sqlite #1

---

📍 Connect Copilot coding agent with Jira, Azure Boards or Linear to delegate work to Copilot in one click without leaving your project management tool.

[Copilot]

Pull request overview

This PR makes the SQLite backend selection safe for Node-targeted bundled artifacts by ensuring the Bun SQLite driver is only resolved at runtime, preventing bun:* imports from leaking into Node bundles.

Changes:

• Switch Bun SQLite loading to runtime-only resolution (avoid static bun:sqlite imports).
• Add a bundling-focused runtime test to validate Node-targeted output can be loaded and doesn’t include a static bun:sqlite import.
• Document that the Bun SQLite backend is loaded only at runtime, improving guidance for Node consumers.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
src/runtime.ts	Uses runtime resolution to avoid static bun:sqlite imports in Node-targeted bundles while preserving Bun-first behavior.
tests/runtime.test.ts	Adds a bundling regression test for Node-targeted output safety.
README.md	Documents runtime-only Bun SQLite loading for Node-targeted bundle compatibility.