bunderstack 0.7.0 → 0.9.0

package/src/lifecycle.ts

@@ -30,13 +30,18 @@ export class Lifecycle {
     this.#closePromise = (async () => {
       const cleanups = [...this.#cleanups].reverse()
       this.#cleanups.clear()
-      const results = await Promise.allSettled(cleanups.map((cleanup) => cleanup()))
+      const results = await Promise.allSettled(
+        cleanups.map(async (cleanup) => cleanup()),
+      )
       this.#status = 'closed'
       const errors = results.flatMap((result) =>
         result.status === 'rejected' ? [result.reason] : [],
       )
       if (errors.length > 0) {
-        throw new AggregateError(errors, '[bunderstack] lifecycle cleanup failed')
+        throw new AggregateError(
+          errors,
+          '[bunderstack] lifecycle cleanup failed',
+        )
       }
     })()
     return this.#closePromise

package/src/manifest.ts

@@ -8,6 +8,7 @@ import { getTableName, isTable } from 'drizzle-orm'
 import type { Dialect } from './dialect'
 import type { EnvConfigInput } from './env'
 import type { JobsDefs } from './jobs/define'
+import type { RealtimeTransport } from './realtime/facade'
 import type { ResolvedBucket, ResolvedStorageBuckets } from './storage/buckets'
 import {
   bunderstackCronRuns,
@@ -29,6 +30,7 @@ export type BunderstackManifest = {
   defaultBucket: string
   buckets: { name: string; visibility: ResolvedBucket['visibility'] }[]
   realtime: boolean
+  realtimeTransport: RealtimeTransport
   env: { server: ManifestEnvVar[]; client: ManifestEnvVar[] }
   background: {
     jobs: { name: string }[]
@@ -60,6 +62,7 @@ export function buildManifest(args: {
   storage: ResolvedStorageBuckets
   envConfig: EnvConfigInput | undefined
   realtime: boolean
+  realtimeTransport: RealtimeTransport
   jobs: JobsDefs | undefined
 }): BunderstackManifest {
   return {
@@ -78,6 +81,7 @@ export function buildManifest(args: {
       visibility: bucket.visibility,
     })),
     realtime: args.realtime,
+    realtimeTransport: args.realtimeTransport,
     env: {
       server: describeSection(args.envConfig?.server),
       client: describeSection(args.envConfig?.client),

package/src/provision-internals.ts

@@ -1,6 +1,6 @@
+import type { Driver } from './db'
 // src/provision-internals.ts
 import type { AnyDb, Dialect } from './dialect'
-import type { Driver } from './db'
 
 /**
  * Hidden handle connecting `createBunderstack()` to the optional
@@ -21,6 +21,7 @@ export interface ProvisionInternals {
   migrationsFolder: string
   dialect: Dialect
   driver: Driver
+  adapter: import('./database/adapter').DatabaseAdapter
 }
 
 export interface WithProvisionInternals {

package/src/provision.ts

@@ -11,7 +11,10 @@ import {
 } from './provision-internals'
 
 /** Create the local backing directory for file-based urls, per dialect. */
-async function ensureLocalDataDir(url: string, dialect: Dialect): Promise<void> {
+async function ensureLocalDataDir(
+  url: string,
+  dialect: Dialect,
+): Promise<void> {
   if (dialect === 'pg') {
     // PGlite data dir: `file:<dir>` or a bare path; server/memory urls need nothing.
     if (/^postgres(ql)?:\/\//.test(url)) return
@@ -54,11 +57,7 @@ export async function provisionSchema<TSchema extends Record<string, unknown>>(
 
   let kit: typeof import('drizzle-kit/api')
   try {
-    // Ignore comments keep bundlers (vite/nitro, webpack) from resolving
-    // drizzle-kit at build time — this branch only runs in development.
-    kit = await import(
-      /* @vite-ignore */ /* webpackIgnore: true */ 'drizzle-kit/api'
-    )
+    kit = await import('drizzle-kit/api')
   } catch (cause) {
     throw new Error(DRIZZLE_KIT_HINT, { cause })
   }
@@ -89,13 +88,6 @@ export async function provisionSchema<TSchema extends Record<string, unknown>>(
   )
 }
 
-const MIGRATOR_MODULES = {
-  libsql: 'drizzle-orm/libsql/migrator',
-  pglite: 'drizzle-orm/pglite/migrator',
-  'bun-sql': 'drizzle-orm/bun-sql/migrator',
-  'postgres-js': 'drizzle-orm/postgres-js/migrator',
-} as const
-
 /**
  * Provision the database for a Bunderstack app.
  *
@@ -120,16 +112,13 @@ export async function provision(
     )
   }
 
-  const { db, schema, databaseUrl, migrationsFolder, dialect, driver } =
+  const { db, schema, databaseUrl, migrationsFolder, dialect, adapter } =
     internals
   const journal = join(migrationsFolder, 'meta', '_journal.json')
 
   if (await exists(journal)) {
     await ensureLocalDataDir(databaseUrl, dialect)
-    const { migrate } = (await import(
-      /* @vite-ignore */ /* webpackIgnore: true */ MIGRATOR_MODULES[driver]
-    )) as { migrate: (db: never, cfg: { migrationsFolder: string }) => Promise<void> }
-    await migrate(db as never, { migrationsFolder })
+    await adapter.migrate(db as never, migrationsFolder)
     return
   }
 

package/src/realtime/facade.ts

@@ -2,6 +2,8 @@ import { getTableName, type InferSelectModel, type Table } from 'drizzle-orm'
 
 import type { RealtimeAction, RealtimeBroker } from './index'
 
+export type RealtimeTransport = 'disabled' | 'memory' | 'redis'
+
 export type SchemaTable<TSchema extends Record<string, unknown>> = Extract<
   TSchema[keyof TSchema],
   Table
@@ -11,6 +13,7 @@ export interface RealtimeFacade<
   TSchema extends Record<string, unknown> = Record<string, unknown>,
 > {
   readonly enabled: boolean
+  readonly transport: RealtimeTransport
 
   publish<TTable extends SchemaTable<TSchema>>(
     table: TTable,
@@ -21,9 +24,22 @@ export interface RealtimeFacade<
 
 export function createRealtimeFacade<TSchema extends Record<string, unknown>>(
   broker?: RealtimeBroker,
+  transport: RealtimeTransport = broker ? 'memory' : 'disabled',
 ): RealtimeFacade<TSchema> {
+  if (!broker && transport !== 'disabled') {
+    throw new Error(
+      '[bunderstack] an enabled realtime transport requires a broker',
+    )
+  }
+  if (broker && transport === 'disabled') {
+    throw new Error(
+      '[bunderstack] a realtime broker cannot use the disabled transport',
+    )
+  }
+
   return {
     enabled: broker !== undefined,
+    transport,
     async publish(table, action, record) {
       if (!broker) return
       await broker.publish(

package/src/typeid.ts

@@ -16,10 +16,10 @@ const PREFIX_RE = /^[a-z]([a-z_]{0,61}[a-z])?$/
 // 26 base32 chars from the alphabet above.
 const SUFFIX_RE = /^[0-9a-hjkmnp-tv-z]{26}$/
 
-declare const brand: unique symbol
+declare const typeIdBrand: unique symbol
 
 /** A branded TypeID string. `TypeId<'post'>` is incompatible with `TypeId<'user'>`. */
-export type TypeId<P extends string> = string & { readonly [brand]: P }
+export type TypeId<P extends string> = string & { readonly [typeIdBrand]?: P }
 
 /** Encode a 16-byte UUID into the 26-character base32 suffix. */
 export function encode(bytes: Uint8Array): string {