bunderstack 0.6.1 → 0.8.0

package/src/jobs/define.ts

@@ -35,6 +35,8 @@ export type JobsRuntimeFacade = {
   tick(now?: number): Promise<void>
 }
 
+import type { RealtimeFacade } from '../realtime/facade'
+
 export type JobContext<
   TSchema extends Record<string, unknown> = Record<string, unknown>,
   TEnvResult = Record<string, unknown>,
@@ -44,6 +46,7 @@ export type JobContext<
   email: EmailFacade
   storage: StorageFacade
   jobs: JobsRuntimeFacade
+  realtime: RealtimeFacade<TSchema>
 }
 
 export type QueueJobDefinition<

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/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

@@ -0,0 +1,36 @@
+import { getTableName, type InferSelectModel, type Table } from 'drizzle-orm'
+
+import type { RealtimeAction, RealtimeBroker } from './index'
+
+export type SchemaTable<TSchema extends Record<string, unknown>> = Extract<
+  TSchema[keyof TSchema],
+  Table
+>
+
+export interface RealtimeFacade<
+  TSchema extends Record<string, unknown> = Record<string, unknown>,
+> {
+  readonly enabled: boolean
+
+  publish<TTable extends SchemaTable<TSchema>>(
+    table: TTable,
+    action: RealtimeAction,
+    record: InferSelectModel<TTable>,
+  ): Promise<void>
+}
+
+export function createRealtimeFacade<TSchema extends Record<string, unknown>>(
+  broker?: RealtimeBroker,
+): RealtimeFacade<TSchema> {
+  return {
+    enabled: broker !== undefined,
+    async publish(table, action, record) {
+      if (!broker) return
+      await broker.publish(
+        getTableName(table),
+        action,
+        record as unknown as Record<string, unknown>,
+      )
+    },
+  }
+}

package/src/trpc.ts

@@ -6,6 +6,7 @@ import type { AccessUser } from './access'
 import type { DbFor } from './db'
 import type { EmailFacade } from './email'
 import type { JobsRuntimeFacade } from './jobs/index'
+import type { RealtimeFacade } from './realtime/facade'
 
 export type TRPCContext<
   TSchema extends Record<string, unknown>,
@@ -16,6 +17,7 @@ export type TRPCContext<
   env: TEnvResult
   email: EmailFacade
   jobs: JobsRuntimeFacade
+  realtime: RealtimeFacade<TSchema>
   req: Request
 }
 

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 {