Resolver

A dynamic database adapter resolver for the ValtheraDB ecosystem. Automatically selects and instantiates the appropriate database storage adapter based on configuration, environment variables, or fallback defaults.

Installation

npm i @wxn0brp/db-resolver @wxn0brp/db-core

Usage

import { createAdapter } from "@wxn0brp/db-resolver";
import { ValtheraClass } from "@wxn0brp/db-core";

const adapter = await createAdapter({ name: "master" });
const db = new ValtheraClass({ adapter });

More Examples

// Force a specific adapter
await createAdapter({ force: "bin" });
// same as
await createAdapter({ force: "bin:bin" });

// Use environment variables
process.env.VALTHERA_MASTER = "sqlite";
await createAdapter({ name: "master" });

// Use default fallback
await createAdapter({ name: "master", def: "dir" });

Configuration

The resolver determines which database adapter to use based on the following priority:

1. force option - Explicitly specify the storage package and variant
2. Environment variables - Set VALTHERA_<NAME> and optionally VALTHERA_<NAME>_OPTS
3. def option - Define a default fallback
4. Default behavior - Falls back to ./vdb-data/<name> directory storage

Options

| Option | Type | Description | |--------|------|-------------| | name | string | Identifier used for environment variable lookup (VALTHERA_<NAME>) | | opts | any[] | Options passed to the database adapter constructor | | def | string | Default adapter in format "package:variant" | | force | string | Force a specific adapter in format "package:variant" |

Environment Variables

• VALTHERA_<NAME> - Adapter identifier in format "package" or "package:variant" (e.g., VALTHERA_MASTER=dir:dir)
• VALTHERA_<NAME>_OPTS - JSON array of constructor options for the adapter
• VALTHERA_RESOLVER_MAX_DEPTH - Maximum depth to search for adapters

Dynamic install

If the adapter is not installed and process.env.NODE_ENV !== "production", it will be installed automatically.

License

MIT