Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
QueryBuilder
✓ import { QueryBuilder } from 'hazo_connect/server'
✗ import { QueryBuilder } from 'hazo_connect'
QueryBuilder is only exported from 'hazo_connect/server'. Importing from root only gives types.
createHazoConnect
✓ import { createHazoConnect } from 'hazo_connect/server'
✗ const createHazoConnect = require('hazo_connect/server').createHazoConnect
Package is ESM-only; require() will fail with ERR_REQUIRE_ESM.
createHazoConnectFromEnv
✓ import { createHazoConnectFromEnv } from 'hazo_connect/nextjs/setup'
✗ import { createHazoConnectFromEnv } from 'hazo_connect/server'
Setup helpers are in the 'nextjs/setup' subpath, not 'server'.
createApiRouteHandler
✓ import { createApiRouteHandler } from 'hazo_connect/nextjs'
For Next.js API route helpers, use 'hazo_connect/nextjs'.
HazoConnectConfig
✓ import type { HazoConnectConfig } from 'hazo_connect/ui'
✗ import { HazoConnectConfig } from 'hazo_connect'
Types for client components should be imported from 'hazo_connect/ui' to avoid importing server code.
Demonstrates Next.js API route using environment-based SQLite config, query builder with filters, sorting, and pagination.
import { createHazoConnectFromEnv } from 'hazo_connect/nextjs/setup';
import { QueryBuilder } from 'hazo_connect/server';
import { NextResponse } from 'next/server';
// Ensure environment variables are set:
// HAZO_CONNECT_TYPE=sqlite
// HAZO_CONNECT_SQLITE_PATH=./database.sqlite
// HAZO_CONNECT_ENABLE_ADMIN_UI=true
export async function GET() {
const hazo = createHazoConnectFromEnv();
const users = await hazo.query(
new QueryBuilder()
.from('users')
.select('id, name, email')
.eq('active', true)
.order('created_at', { ascending: false })
.limit(10)
);
return NextResponse.json({ data: users });
}
Errors
Common errors & fixes
Error: Cannot find module 'hazo_connect/server'
Typo or wrong import path: using root import instead of subpath.
fixChange import to 'hazo_connect/server' for server-side functionality.
Error: Must use import to load ES Module: /path/to/node_modules/hazo_connect/dist/index.js
Using require() in a CommonJS file; package is ESM-only.
fixUse import statement (ESM) or dynamic import(). Add '"type": "module"' to package.json.
Error: HazoConnectConfig is not a constructor
Importing type as value from 'hazo_connect' or wrong subpath.
fixUse import type { HazoConnectConfig } from 'hazo_connect/ui'. Error: createHazoConnectFromEnv is not defined
Importing from wrong subpath; this function is only in 'hazo_connect/nextjs/setup'.
fixImport from 'hazo_connect/nextjs/setup'.
Audit
Dependencies
hazo_corerequiredCore runtime dependency for database operations
hazo_logsrequiredLogging dependency injected via dependency injection
hazo_configoptionalOptional INI config file support
hazo_uioptionalRequired for SQLite admin UI
hazo_debugoptionalRequired for SQLite admin UI