bunderstack 0.11.0 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunderstack",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Batteries-included backend framework for Bun: CRUD APIs, auth, file storage, realtime, tRPC, email, and validated env from a single Drizzle schema and config object.",
   "keywords": [
     "backend",

package/src/index.ts

@@ -58,7 +58,7 @@ import {
 import { createRealtimeBroker, buildRealtimeRouter } from './realtime/index'
 import { createRedisRealtimeBroker } from './realtime/redis'
 import { deleteFileWithDerivatives } from './storage/delete'
-import { deleteFileMetaRow } from './storage/file-meta'
+import { deleteFileMetaRow, insertReadyFile } from './storage/file-meta'
 import { createBucketStorages } from './storage/registry'
 import { buildBucketStorageRouter } from './storage/router'
 import { sweepOrphans } from './storage/sweep'
@@ -115,6 +115,17 @@ export interface StorageFacade {
     key: string,
     opts?: { bucket?: string; expiresIn?: number },
   ): Promise<string>
+  /**
+   * Upload bytes as a ready file and register it in file_meta so it is
+   * accessible via `GET /api/files/<key>`. Use this for server-generated
+   * files (e.g. generated PDFs) that are not uploaded by end-users.
+   */
+  upload(
+    key: string,
+    body: ArrayBuffer | Uint8Array,
+    contentType: string,
+    opts?: { ownerId?: string; filename?: string },
+  ): Promise<void>
 }
 
 export type AppStartWorkerOptions = Omit<StartWorkerOptions, 'tick'>
@@ -478,7 +489,7 @@ export async function createBunderstack<
         const bucketName =
           opts.bucket ??
           key.split('/')[0] ??
-          registry.defaultBucketName
+          config.storage.defaultBucket
         const adapter = registry.get(bucketName)?.adapter
         if (adapter?.presignGet) {
           return adapter.presignGet(key, {
@@ -487,6 +498,23 @@ export async function createBunderstack<
         }
         return `/api/files/${key}`
       },
+      async upload(key, body, contentType, opts = {}) {
+        const bucketName = key.split('/')[0] ?? ''
+        const adapter = registry.get(bucketName)?.adapter
+        if (!adapter) throw new Error(`Unknown bucket: ${bucketName}`)
+        const u8 = body instanceof Uint8Array ? body : new Uint8Array(body)
+        const buf: ArrayBuffer = u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength) as ArrayBuffer
+        await adapter.upload(key, buf, contentType)
+        await insertReadyFile(db, {
+          fileId: key,
+          bucket: bucketName,
+          ownerId: opts.ownerId ?? null,
+          scopeJson: null,
+          filename: opts.filename ?? key.split('/').at(-1) ?? null,
+          contentType,
+          size: buf.byteLength,
+        })
+      },
     }
     const jobRunner = jobsDefs
       ? createJobRunner({
@@ -613,6 +641,7 @@ export async function createBunderstack<
               email,
               jobs,
               realtime,
+              storage,
               req,
             }),
           })

package/src/storage/router.ts

@@ -371,14 +371,16 @@ export function buildBucketStorageRouter(
     return c.json({ fileId, url }, 200)
   })
 
-  // ─── GET /:bucket/:id ─────────────────────────────────────────────────────
-  router.get('/:bucket/:id', async (c) => {
+  // ─── GET /:bucket/* ──────────────────────────────────────────────────────
+  // NOTE: wildcard captures nested paths like `adaptations/uuid/resume.pdf`.
+  router.get('/:bucket/*', async (c) => {
     const bucketName = c.req.param('bucket')
     const entry = registry.get(bucketName)
     if (!entry) return apiError(c, ErrorCode.NOT_FOUND, 'Unknown bucket', 404)
     const { bucket, adapter } = entry
 
-    const id = c.req.param('id')
+    const mountPrefix = c.req.routePath.replace(/\/:[^\/]+\/\*$/, '')
+    const id = c.req.path.slice(`${mountPrefix}/${bucketName}/`.length)
     const fileId = `${bucketName}/${id}`
 
     const row = await getFileMeta(db, fileId)
@@ -467,14 +469,15 @@ export function buildBucketStorageRouter(
     return new Response(res.body, { status: res.status, headers })
   })
 
-  // ─── DELETE /:bucket/:id ──────────────────────────────────────────────────
-  router.delete('/:bucket/:id', async (c) => {
+  // ─── DELETE /:bucket/* ─────────────────────────────────────────────────
+  router.delete('/:bucket/*', async (c) => {
     const bucketName = c.req.param('bucket')
     const entry = registry.get(bucketName)
     if (!entry) return apiError(c, ErrorCode.NOT_FOUND, 'Unknown bucket', 404)
     const { bucket, adapter } = entry
 
-    const id = c.req.param('id')
+    const mountPrefix = c.req.routePath.replace(/\/:[^/]+\/\*$/, '')
+    const id = c.req.path.slice(`${mountPrefix}/${bucketName}/`.length)
     const fileId = `${bucketName}/${id}`
 
     const row = await getFileMeta(db, fileId)

package/src/trpc.ts

@@ -7,6 +7,7 @@ import type { DbFor } from './db'
 import type { EmailFacade } from './email'
 import type { JobsRuntimeFacade } from './jobs/index'
 import type { RealtimeFacade } from './realtime/facade'
+import type { StorageFacade } from './index'
 
 export type TRPCContext<
   TSchema extends Record<string, unknown>,
@@ -18,6 +19,7 @@ export type TRPCContext<
   email: EmailFacade
   jobs: JobsRuntimeFacade
   realtime: RealtimeFacade<TSchema>
+  storage: StorageFacade
   req: Request
 }