bunderstack 0.21.0 → 0.21.1

package/README.md

@@ -1,6 +1,6 @@
 # bunderstack
 
-The server package for Bunderstack's unified, type-safe oRPC backend.
+The complete backend & full-stack framework for Bun: type-safe oRPC APIs, auth, storage, realtime, jobs, email, live views, and client bindings from one single file declaration.
 
 ```sh
 bun add bunderstack better-auth drizzle-orm valibot @libsql/client
@@ -44,16 +44,28 @@ Use the in-memory Publisher for one process or configure
 `realtime: { redis: process.env.REDIS_URL! }` for multi-process delivery and
 replay. Deployment metadata is generated with `bunx bunderstack blueprint`.
 
+## Package Subpaths (0.21+)
+
+- `bunderstack` — Backend runtime (`createBunderstack`, `provision`, `defineApi`, `buildApiRegistry`)
+- `bunderstack/client` — Framework-neutral RPC & LiveView client (`createClient`, `createLiveView`)
+- `bunderstack/client/rest` — Type-safe REST client
+- `bunderstack/client/react`, `bunderstack/client/solid`, `bunderstack/client/vue`, `bunderstack/client/svelte` — LiveView UI bindings
+- `bunderstack/query` & `bunderstack/query/react` — TanStack Query client (`createClient`, `syncRealtime`)
+- `bunderstack/sync` — TanStack DB collections (`createSyncClient`)
+- `bunderstack/start` & `bunderstack/start/auth` — TanStack Start full-stack integration
+- `bunderstack/database/*` — Database adapters (`libsql`, `postgres-js`, `bun-sql`, `pglite`)
+- `bunderstack/storage/*` — Storage adapters (`s3`, `disk`)
+- `bunderstack/email/*` — Email adapters (`smtp`, `resend`, `console`)
+- `bunderstack/jobs/*` — Job queue adapters (`memory`, `redis`)
+
 See the [workspace documentation](https://github.com/kirill-dev-pro/bunderstack#readme) for webhooks, clients,
 storage, collections, lifecycle, and complete examples.
 
 ## Upgrading
 
-0.17 is a breaking release: tRPC became oRPC, generated `list` takes nested
-typed `filters`, error codes are oRPC's own, and realtime names tables by their
-schema key. Every change is listed with before/after code in the migration
-guides, which ship with the package as `CHANGELOG.md` and live in full at:
+Every change is listed with before/after code in the migration guides, which live in full at:
 
+- [Migrating to 0.21](https://github.com/kirill-dev-pro/bunderstack/blob/main/docs/MIGRATION-0.21.md)
 - [Migrating to 0.17](https://github.com/kirill-dev-pro/bunderstack/blob/main/docs/MIGRATION-0.17.md)
 - [Migrating to 0.16](https://github.com/kirill-dev-pro/bunderstack/blob/main/docs/MIGRATION-0.16.md)
 

package/dist/start/index.d.ts

@@ -1,5 +1,5 @@
 import { QueryClient } from '@tanstack/react-query';
-import { type AnyBunderstackApp, type BunderstackSyncClient } from '../sync/index.js';
+import { type AnyBunderstackApp, type BunderstackClient } from '../query/index.js';
 export { createIsomorphicFetch } from './isomorphic-fetch.js';
 export type BunderstackStartOptions = {
     /** API mount point. Defaults to '/api'. */
@@ -9,7 +9,7 @@ export type BunderstackStartOptions = {
 };
 /**
  * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible
- * QueryClient defaults, and a sync client whose tables and buckets are
+ * QueryClient defaults, and a typed query client whose procedures and buckets are
  * inferred from the server app type.
  *
  * @example
@@ -20,7 +20,7 @@ export type BunderstackStartOptions = {
  */
 export declare function bunderstackStart<TApp extends AnyBunderstackApp>(options?: BunderstackStartOptions): {
     createQueryClient: () => QueryClient;
-    createApi: (queryClient: QueryClient) => BunderstackSyncClient<TApp>;
+    createApi: (queryClient: QueryClient) => BunderstackClient<TApp>;
 };
 type StartRequestContext = {
     request: Request;

package/dist/start/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,uBAAuB,GAAG;IACpC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,iBAAiB,EAC7D,OAAO,GAAE,uBAA4B;;6BAUV,WAAW,KAAG,qBAAqB,CAAC,IAAI,CAAC;EAOrE;AAED,KAAK,mBAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAC/C,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEnE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC7C,GAAG;IACF,GAAG,EAAE,YAAY,CAAA;IACjB,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,YAAY,CAAA;CACrB,CAGA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE;QACJ,GAAG,EAAE;YACH,UAAU,EAAE,CAAC,IAAI,EAAE;gBACjB,OAAO,EAAE,OAAO,CAAA;aACjB,KAAK,OAAO,CAAC;gBAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;aAAE,GAAG,IAAI,CAAC,CAAA;SACnD,CAAA;KACF,CAAA;CACF,CAAA;AAED,iFAAiF;AACjF,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,uBAAuB,GAAG;IACpC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,iBAAiB,EAC7D,OAAO,GAAE,uBAA4B;;6BAUV,WAAW,KAAG,iBAAiB,CAAC,IAAI,CAAC;EAOjE;AAED,KAAK,mBAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAC/C,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEnE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC7C,GAAG;IACF,GAAG,EAAE,YAAY,CAAA;IACjB,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,YAAY,CAAA;CACrB,CAGA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE;QACJ,GAAG,EAAE;YACH,UAAU,EAAE,CAAC,IAAI,EAAE;gBACjB,OAAO,EAAE,OAAO,CAAA;aACjB,KAAK,OAAO,CAAC;gBAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;aAAE,GAAG,IAAI,CAAC,CAAA;SACnD,CAAA;KACF,CAAA;CACF,CAAA;AAED,iFAAiF;AACjF,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG7B"}

package/dist/start/index.js

@@ -1,10 +1,10 @@
 import { QueryClient } from '@tanstack/react-query';
-import { createSyncClient, } from '../sync/index.js';
+import { createClient, } from '../query/index.js';
 import { createIsomorphicFetch } from './isomorphic-fetch.js';
 export { createIsomorphicFetch } from './isomorphic-fetch.js';
 /**
  * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible
- * QueryClient defaults, and a sync client whose tables and buckets are
+ * QueryClient defaults, and a typed query client whose procedures and buckets are
  * inferred from the server app type.
  *
  * @example
@@ -21,7 +21,7 @@ export function bunderstackStart(options = {}) {
                 queries: { staleTime: options.staleTime ?? 30_000 },
             },
         }),
-        createApi: (queryClient) => createSyncClient({
+        createApi: (queryClient) => createClient({
             queryClient,
             fetch: isoFetch,
             baseUrl: options.baseUrl,

package/dist/start/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EACL,gBAAgB,GAGjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAS1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAmC,EAAE;IAErC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IACxC,OAAO;QACL,iBAAiB,EAAE,GAAG,EAAE,CACtB,IAAI,WAAW,CAAC;YACd,cAAc,EAAE;gBACd,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE;aACpD;SACF,CAAC;QACJ,SAAS,EAAE,CAAC,WAAwB,EAA+B,EAAE,CACnE,gBAAgB,CAAO;YACrB,WAAW;YACX,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;KACL,CAAA;AACH,CAAC;AAKD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAEjC;IAMC,MAAM,MAAM,GAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAClE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AACrE,CAAC;AAoBD,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAe,EACf,OAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3E,OAAO,OAAO,EAAE,IAAI,IAAI,IAAI,CAAA;AAC9B,CAAC","sourcesContent":["import { QueryClient } from '@tanstack/react-query'\n\nimport {\n  createSyncClient,\n  type AnyBunderstackApp,\n  type BunderstackSyncClient,\n} from '../sync/index'\nimport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport type BunderstackStartOptions = {\n  /** API mount point. Defaults to '/api'. */\n  baseUrl?: string\n  /** Default query staleTime (ms). Defaults to 30_000. */\n  staleTime?: number\n}\n\n/**\n * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible\n * QueryClient defaults, and a sync client whose tables and buckets are\n * inferred from the server app type.\n *\n * @example\n * // src/api.ts — NOT src/client.ts, which is a reserved TanStack Start\n * // entry-point name (it would replace the hydration entry).\n * import type { App } from './bunderstack'\n * export const { createQueryClient, createApi } = bunderstackStart<App>()\n */\nexport function bunderstackStart<TApp extends AnyBunderstackApp>(\n  options: BunderstackStartOptions = {},\n) {\n  const isoFetch = createIsomorphicFetch()\n  return {\n    createQueryClient: () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: { staleTime: options.staleTime ?? 30_000 },\n        },\n      }),\n    createApi: (queryClient: QueryClient): BunderstackSyncClient<TApp> =>\n      createSyncClient<TApp>({\n        queryClient,\n        fetch: isoFetch,\n        baseUrl: options.baseUrl,\n      }),\n  }\n}\n\ntype StartRequestContext = { request: Request }\ntype StartHandler = (ctx: StartRequestContext) => Promise<Response>\n\n/**\n * Handlers object for the catch-all API file route.\n *\n * @example\n * // src/routes/api/$.tsx\n * export const Route = createFileRoute('/api/$')({\n *   server: { handlers: createApiHandlers(app) },\n * })\n */\nexport function createApiHandlers(app: {\n  handler: (req: Request) => Promise<Response>\n}): {\n  GET: StartHandler\n  POST: StartHandler\n  PATCH: StartHandler\n  DELETE: StartHandler\n} {\n  const handle: StartHandler = ({ request }) => app.handler(request)\n  return { GET: handle, POST: handle, PATCH: handle, DELETE: handle }\n}\n\nexport type SessionUser = {\n  id: string\n  email: string\n  name: string\n  image?: string | null\n  role?: string\n}\n\ntype SessionApp = {\n  auth: {\n    api: {\n      getSession: (opts: {\n        headers: Headers\n      }) => Promise<{ user: SessionUser | null } | null>\n    }\n  }\n}\n\n/** Resolve the BetterAuth session user for an incoming request (server-side). */\nexport async function getSessionUser(\n  app: SessionApp,\n  request: Request,\n): Promise<SessionUser | null> {\n  const session = await app.auth.api.getSession({ headers: request.headers })\n  return session?.user ?? null\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EACL,YAAY,GAGb,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAS1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAmC,EAAE;IAErC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IACxC,OAAO;QACL,iBAAiB,EAAE,GAAG,EAAE,CACtB,IAAI,WAAW,CAAC;YACd,cAAc,EAAE;gBACd,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE;aACpD;SACF,CAAC;QACJ,SAAS,EAAE,CAAC,WAAwB,EAA2B,EAAE,CAC/D,YAAY,CAAO;YACjB,WAAW;YACX,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;KACL,CAAA;AACH,CAAC;AAKD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAEjC;IAMC,MAAM,MAAM,GAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAClE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AACrE,CAAC;AAoBD,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAe,EACf,OAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3E,OAAO,OAAO,EAAE,IAAI,IAAI,IAAI,CAAA;AAC9B,CAAC","sourcesContent":["import { QueryClient } from '@tanstack/react-query'\n\nimport {\n  createClient,\n  type AnyBunderstackApp,\n  type BunderstackClient,\n} from '../query/index'\nimport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport type BunderstackStartOptions = {\n  /** API mount point. Defaults to '/api'. */\n  baseUrl?: string\n  /** Default query staleTime (ms). Defaults to 30_000. */\n  staleTime?: number\n}\n\n/**\n * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible\n * QueryClient defaults, and a typed query client whose procedures and buckets are\n * inferred from the server app type.\n *\n * @example\n * // src/api.ts — NOT src/client.ts, which is a reserved TanStack Start\n * // entry-point name (it would replace the hydration entry).\n * import type { App } from './bunderstack'\n * export const { createQueryClient, createApi } = bunderstackStart<App>()\n */\nexport function bunderstackStart<TApp extends AnyBunderstackApp>(\n  options: BunderstackStartOptions = {},\n) {\n  const isoFetch = createIsomorphicFetch()\n  return {\n    createQueryClient: () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: { staleTime: options.staleTime ?? 30_000 },\n        },\n      }),\n    createApi: (queryClient: QueryClient): BunderstackClient<TApp> =>\n      createClient<TApp>({\n        queryClient,\n        fetch: isoFetch,\n        baseUrl: options.baseUrl,\n      }),\n  }\n}\n\ntype StartRequestContext = { request: Request }\ntype StartHandler = (ctx: StartRequestContext) => Promise<Response>\n\n/**\n * Handlers object for the catch-all API file route.\n *\n * @example\n * // src/routes/api/$.tsx\n * export const Route = createFileRoute('/api/$')({\n *   server: { handlers: createApiHandlers(app) },\n * })\n */\nexport function createApiHandlers(app: {\n  handler: (req: Request) => Promise<Response>\n}): {\n  GET: StartHandler\n  POST: StartHandler\n  PATCH: StartHandler\n  DELETE: StartHandler\n} {\n  const handle: StartHandler = ({ request }) => app.handler(request)\n  return { GET: handle, POST: handle, PATCH: handle, DELETE: handle }\n}\n\nexport type SessionUser = {\n  id: string\n  email: string\n  name: string\n  image?: string | null\n  role?: string\n}\n\ntype SessionApp = {\n  auth: {\n    api: {\n      getSession: (opts: {\n        headers: Headers\n      }) => Promise<{ user: SessionUser | null } | null>\n    }\n  }\n}\n\n/** Resolve the BetterAuth session user for an incoming request (server-side). */\nexport async function getSessionUser(\n  app: SessionApp,\n  request: Request,\n): Promise<SessionUser | null> {\n  const session = await app.auth.api.getSession({ headers: request.headers })\n  return session?.user ?? null\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunderstack",
-  "version": "0.21.0",
+  "version": "0.21.1",
   "description": "Batteries-included backend framework for Bun: type-safe oRPC APIs, auth, storage, realtime, jobs, email, and validated env from one config.",
   "keywords": [
     "backend",