Release 0.20

[dswbx]

includes:

• upgrade deps #290
• upgrade biome and vscode settings #293
• fix hybrid schema sync #295
• Email Driver: Add Plunk Support #294 🔥
• fix cli url opener and add minimal debug docker config #301
• Fix: cf proxy and modes #302
• Add Cloudflare Vite templates for fullstack deployments #303
• fix: recursive with omitted join clauses #299
• OTP plugin #292
• fix config reconciliation for specific field types, remove lodash #311
• Fix UI client import #307
• fix: putting schema related endpoints behind schema permission and added tests #312
• feat: Add implicit joins in repository where clauses #313
• feat: move postgres as part of the main repo #289
• feat: opfs and sqlocal #308
• feat: add local auth support if api storage provided #315
• feat: add default_role_register and password minLength config #320
• feat(admin): add mcp as main navigation item when enabled, and make it route-aware #321
• feat: add SvelteKit adapter #324
• change license to apache 2.0 #331

---

License change to Apache 2.0

bknd is now licensed under the Apache 2.0 license, making it even more permissive and enterprise-friendly.

MCP in admin navigation

The MCP (Model Context Protocol) tool is now accessible directly from the main navigation when enabled. The UI has been improved to be route-aware, making it easier to interact with AI tools directly from the admin interface.

Improved hybrid mode

The hybrid mode has been enhanced with better type inference and improved configuration handling:

• Reader function can now return objects directly (not just strings)
• Automatic schema syncing in development with sync_required flag
• Better handling of missing config files with automatic defaults

Repository auto-join for related entities

When querying with where clauses that reference related entities, bknd now automatically adds the necessary joins. This means you can filter by related entity fields without explicitly specifying joins:

// automatically joins "author" when filtering by author.name
const posts = await api.data.readMany("posts", {
  where: { "author.name": "John" },
});

Email OTP plugin

A new authentication plugin for passwordless login using one-time passwords sent via email. The plugin supports both login and registration flows, with configurable TTL, custom email templates, and automatic code invalidation.

import { emailOTP } from "bknd/plugins";
import { resendEmail } from "bknd";

export default {
   options: {
      plugins: [
         emailOTP({
            generateEmail: (otp) => ({
               subject: "OTP Code",
               body: `Your OTP code is: ${otp.code}`,
            }),
         })
      ],
   },
} satisfies BkndConfig;

Plunk email driver

Added support for Plunk as an email driver, joining Resend as supported transactional email services:

import { plunkEmail } from "bknd";

export default {
   options: {
      drivers: {
         email: plunkEmail({ 
            apiKey: "<api-key>",
            from: "hello@example.com",
         }),
      },
  }
}

Special thanks to @cameronapak for adding this 🔥

SvelteKit adapter

bknd now has first-class support for SvelteKit applications. The new adapter follows the same pattern as the existing Astro and Next.js adapters. Read more in the SvelteKit integration guide. Special thanks to @screenfluent for adding this 🔥

Postgres support now included

The separate @bknd/postgres package has been merged into the main bknd package. PostgreSQL connections are now available directly:

import { pgPostgres, postgresJs } from "bknd";
import { Pool } from "pg";
import postgres from 'postgres'

// using pg library
const connection = pg({
  pool: new Pool({
    connectionString: "postgresql://user:password@localhost:5432/database",
  }),
});

// using postgres.js
const connection = postgresJs({
  postgres: postgres("postgresql://user:password@localhost:5432/database"),
});

Run bknd in your browser with SQLocal

You can now run bknd entirely in your browser without any server required. Using SQLocal, bknd now supports in-browser SQLite databases using OPFS (Origin Private File System), with data persisting locally in your browser. This is perfect for offline-first applications, local development, or demo purposes.

The new BkndBrowserApp component wraps everything you need to get started:

import { BkndBrowserApp } from "bknd/adapter/browser";
import { Route } from "wouter";

export function App() {
  return (
    <BkndBrowserApp
       config={{
          /* ... your bknd config */
          adminOptions: { basepath: "/admin" }
       }}
       /* add additional options you're used to from `bknd.config.ts` */
       onBuilt={async (app) => {}}
    >
      {/* your routes */}
      <Route path="/" component={() => <div>hello</div>} />
    </BkndBrowserApp>
  );
}

Additionally, bknd now includes the OpfsStorageAdapter for media storage, allowing full file upload/download support in the browser environment.