bunderstack 0.21.1 → 0.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) hide show
  1. package/CHANGELOG.md +55 -0
  2. package/README.md +15 -10
  3. package/dist/api/builder.d.ts +2 -2
  4. package/dist/api/builder.js +1 -1
  5. package/dist/api/builder.js.map +1 -1
  6. package/dist/api/context.d.ts +4 -1
  7. package/dist/api/context.d.ts.map +1 -1
  8. package/dist/api/context.js +2 -0
  9. package/dist/api/context.js.map +1 -1
  10. package/dist/auth.d.ts +8 -0
  11. package/dist/auth.d.ts.map +1 -1
  12. package/dist/auth.js +14 -0
  13. package/dist/auth.js.map +1 -1
  14. package/dist/backend-internals.d.ts +43 -0
  15. package/dist/backend-internals.d.ts.map +1 -0
  16. package/dist/backend-internals.js +2 -0
  17. package/dist/backend-internals.js.map +1 -0
  18. package/dist/backend.d.ts +26 -0
  19. package/dist/backend.d.ts.map +1 -0
  20. package/dist/backend.js +58 -0
  21. package/dist/backend.js.map +1 -0
  22. package/dist/blueprint-generator.d.ts.map +1 -1
  23. package/dist/blueprint-generator.js +41 -51
  24. package/dist/blueprint-generator.js.map +1 -1
  25. package/dist/config.d.ts +0 -6
  26. package/dist/config.d.ts.map +1 -1
  27. package/dist/config.js.map +1 -1
  28. package/dist/database/adapter.d.ts +10 -3
  29. package/dist/database/adapter.d.ts.map +1 -1
  30. package/dist/database/adapter.js.map +1 -1
  31. package/dist/database/bun-sql.d.ts.map +1 -1
  32. package/dist/database/bun-sql.js +1 -3
  33. package/dist/database/bun-sql.js.map +1 -1
  34. package/dist/database/bun-sqlite.d.ts +8 -0
  35. package/dist/database/bun-sqlite.d.ts.map +1 -0
  36. package/dist/database/bun-sqlite.js +56 -0
  37. package/dist/database/bun-sqlite.js.map +1 -0
  38. package/dist/database/libsql.d.ts.map +1 -1
  39. package/dist/database/libsql.js +25 -3
  40. package/dist/database/libsql.js.map +1 -1
  41. package/dist/database/pglite.d.ts.map +1 -1
  42. package/dist/database/pglite.js +25 -4
  43. package/dist/database/pglite.js.map +1 -1
  44. package/dist/database/postgres-js.d.ts.map +1 -1
  45. package/dist/database/postgres-js.js +1 -3
  46. package/dist/database/postgres-js.js.map +1 -1
  47. package/dist/db.d.ts +1 -2
  48. package/dist/db.d.ts.map +1 -1
  49. package/dist/db.js +5 -3
  50. package/dist/db.js.map +1 -1
  51. package/dist/email.d.ts +3 -1
  52. package/dist/email.d.ts.map +1 -1
  53. package/dist/email.js +9 -2
  54. package/dist/email.js.map +1 -1
  55. package/dist/env.d.ts +1 -1
  56. package/dist/env.d.ts.map +1 -1
  57. package/dist/env.js +1 -4
  58. package/dist/env.js.map +1 -1
  59. package/dist/errors.d.ts.map +1 -1
  60. package/dist/errors.js +4 -2
  61. package/dist/errors.js.map +1 -1
  62. package/dist/index.d.ts +3 -108
  63. package/dist/index.d.ts.map +1 -1
  64. package/dist/index.js +1 -484
  65. package/dist/index.js.map +1 -1
  66. package/dist/jobs/define.d.ts +1 -1
  67. package/dist/jobs/define.d.ts.map +1 -1
  68. package/dist/jobs/define.js.map +1 -1
  69. package/dist/jobs/index.js +1 -1
  70. package/dist/jobs/index.js.map +1 -1
  71. package/dist/jobs/queue.d.ts +1 -1
  72. package/dist/jobs/queue.d.ts.map +1 -1
  73. package/dist/jobs/queue.js +1 -2
  74. package/dist/jobs/queue.js.map +1 -1
  75. package/dist/jobs/worker.d.ts +21 -0
  76. package/dist/jobs/worker.d.ts.map +1 -1
  77. package/dist/jobs/worker.js +64 -4
  78. package/dist/jobs/worker.js.map +1 -1
  79. package/dist/logging.d.ts +8 -0
  80. package/dist/logging.d.ts.map +1 -0
  81. package/dist/logging.js +6 -0
  82. package/dist/logging.js.map +1 -0
  83. package/dist/provision-internals.d.ts +1 -1
  84. package/dist/provision-internals.js +1 -1
  85. package/dist/provision-internals.js.map +1 -1
  86. package/dist/provision.d.ts +2 -0
  87. package/dist/provision.d.ts.map +1 -1
  88. package/dist/provision.js +24 -3
  89. package/dist/provision.js.map +1 -1
  90. package/dist/query/infer.d.ts +1 -1
  91. package/dist/query/infer.d.ts.map +1 -1
  92. package/dist/query/infer.js.map +1 -1
  93. package/dist/runtime.d.ts +153 -0
  94. package/dist/runtime.d.ts.map +1 -0
  95. package/dist/runtime.js +537 -0
  96. package/dist/runtime.js.map +1 -0
  97. package/dist/schema-export-pg.js +1 -1
  98. package/dist/schema-export-pg.js.map +1 -1
  99. package/dist/storage/background.d.ts +3 -0
  100. package/dist/storage/background.d.ts.map +1 -0
  101. package/dist/storage/background.js +3 -0
  102. package/dist/storage/background.js.map +1 -0
  103. package/dist/testing/auth.d.ts +85 -0
  104. package/dist/testing/auth.d.ts.map +1 -0
  105. package/dist/testing/auth.js +140 -0
  106. package/dist/testing/auth.js.map +1 -0
  107. package/dist/testing/client.d.ts +6 -0
  108. package/dist/testing/client.d.ts.map +1 -0
  109. package/dist/testing/client.js +9 -0
  110. package/dist/testing/client.js.map +1 -0
  111. package/dist/testing/database.d.ts +6 -0
  112. package/dist/testing/database.d.ts.map +1 -0
  113. package/dist/testing/database.js +8 -0
  114. package/dist/testing/database.js.map +1 -0
  115. package/dist/testing/email.d.ts +15 -0
  116. package/dist/testing/email.d.ts.map +1 -0
  117. package/dist/testing/email.js +32 -0
  118. package/dist/testing/email.js.map +1 -0
  119. package/dist/testing/fixture.d.ts +51 -0
  120. package/dist/testing/fixture.d.ts.map +1 -0
  121. package/dist/testing/fixture.js +178 -0
  122. package/dist/testing/fixture.js.map +1 -0
  123. package/dist/testing/jobs.d.ts +40 -0
  124. package/dist/testing/jobs.d.ts.map +1 -0
  125. package/dist/testing/jobs.js +76 -0
  126. package/dist/testing/jobs.js.map +1 -0
  127. package/dist/testing/logs.d.ts +18 -0
  128. package/dist/testing/logs.d.ts.map +1 -0
  129. package/dist/testing/logs.js +53 -0
  130. package/dist/testing/logs.js.map +1 -0
  131. package/dist/testing/storage.d.ts +7 -0
  132. package/dist/testing/storage.d.ts.map +1 -0
  133. package/dist/testing/storage.js +29 -0
  134. package/dist/testing/storage.js.map +1 -0
  135. package/dist/testing.d.ts +10 -26
  136. package/dist/testing.d.ts.map +1 -1
  137. package/dist/testing.js +3 -9
  138. package/dist/testing.js.map +1 -1
  139. package/llms.txt +51 -14
  140. package/package.json +23 -15
  141. package/skills/creating-bunderstack-apps/references/application-structure.md +16 -12
  142. package/skills/creating-bunderstack-apps/references/runtime-integrations.md +4 -1
  143. package/skills/migrating-to-bunderstack/SKILL.md +7 -6
  144. package/skills/migrating-to-bunderstack/references/audit-checklist.md +4 -4
  145. package/skills/migrating-to-bunderstack/references/runtime-replacements.md +55 -49
package/dist/index.js CHANGED
@@ -1,486 +1,4 @@
1
- // src/index.ts
2
- import { SmartCoercionHandlerPlugin } from '@orpc/json-schema';
3
- import { OpenAPIGenerator, OpenAPIGeneratorError } from '@orpc/openapi';
4
- import { OpenAPIHandler } from '@orpc/openapi/fetch';
5
- import { RPCHandler } from '@orpc/server/fetch';
6
- import { ValibotToJsonSchemaConverter } from '@orpc/valibot';
7
- import { validateAndResolveAccess } from './access.js';
8
- import { createApiBuilder } from './api/builder.js';
9
- import { createApiContext } from './api/context.js';
10
- import { buildCrudApiRouter } from './api/crud-router.js';
11
- import { mergeOpenAPISpecs } from './api/openapi.js';
12
- import { buildRealtimeApiRouter } from './api/realtime-router.js';
13
- import { buildApiRegistry, normalizeForeignOpenAPISpec } from './api/registry.js';
14
- import { buildApiRouter } from './api/router.js';
15
- import { buildStorageApiRouter } from './api/storage-router.js';
16
- import { createAuth, toAuthSessionResolver, withEmailAuthDefaults, } from './auth.js';
17
- import { resolveConfig } from './config.js';
18
- import { resolveAuthConfig, resolveRealtimeRedisUrl } from './config.js';
19
- import { createDb } from './db.js';
20
- import { detectDialect } from './dialect.js';
21
- import { createEmail, emailProviderTag } from './email.js';
22
- import { validateEnv } from './env.js';
23
- import { buildHandler } from './handler.js';
24
- import { withInternalTables } from './internal-tables.js';
25
- import { createJobsBuilder, createJobRunner, enqueueJob, startJobWorker, validateJobsDefs, } from './jobs/index.js';
26
- import { Lifecycle } from './lifecycle.js';
27
- import { buildManifest } from './manifest.js';
28
- import { PROVISION_INTERNALS, } from './provision-internals.js';
29
- import { createRealtimeFacade, } from './realtime/facade.js';
30
- import { createMemoryRealtimePublisher, createRedisRealtimePublisher, } from './realtime/publisher.js';
31
- import { deleteFileWithDerivatives } from './storage/delete.js';
32
- import { deleteFileMetaRow, insertReadyFile } from './storage/file-meta.js';
33
- import { createStorageOperations } from './storage/operations.js';
34
- import { createBucketStorages } from './storage/registry.js';
35
- import { sweepOrphans } from './storage/sweep.js';
36
- function waitForWorkerShutdown(signal, installProcessListeners) {
37
- if (signal.aborted)
38
- return Promise.resolve();
39
- return new Promise((resolve) => {
40
- const done = () => {
41
- signal.removeEventListener('abort', done);
42
- if (installProcessListeners) {
43
- process.removeListener('SIGINT', done);
44
- process.removeListener('SIGTERM', done);
45
- }
46
- resolve();
47
- };
48
- signal.addEventListener('abort', done, { once: true });
49
- if (installProcessListeners) {
50
- process.once('SIGINT', done);
51
- process.once('SIGTERM', done);
52
- }
53
- });
54
- }
55
- /** Default age before an unconfirmed `pending` file is treated as an orphan. */
56
- const DEFAULT_PENDING_TTL_MS = 30 * 60_000;
57
- export async function createBunderstack(options) {
58
- const dialect = detectDialect(options.schema);
59
- const jobsDefs = options.jobs
60
- ? typeof options.jobs === 'function'
61
- ? options.jobs(createJobsBuilder())
62
- : options.jobs
63
- : undefined;
64
- if (jobsDefs)
65
- validateJobsDefs(jobsDefs);
66
- // Env is validated FIRST: the app refuses to boot on missing/invalid vars,
67
- // and everything downstream consumes the result.
68
- const env = validateEnv(options.env, {
69
- emailProvider: options.processEnv?.BUNDERSTACK_EMAIL_PROVIDER ??
70
- emailProviderTag(options.email),
71
- defaultDatabaseUrl: dialect === 'pg' ? 'file:./data.pglite' : 'file:./data.db',
72
- source: options.processEnv,
73
- });
74
- const config = resolveConfig(options, env, options.processEnv);
75
- // Adapters use Drizzle mocks during deployment introspection, so the database
76
- // and Redis below never touch external services.
77
- const introspect = process.env.BUNDERSTACK_INTROSPECT === '1';
78
- // Merge bunderstack's internal tables (file-meta, idempotency) into the
79
- // schema used for the db client + provisioning. CRUD/access stay on the USER
80
- // schema so internal tables never get a CRUD route.
81
- const mergedSchema = withInternalTables(options.schema);
82
- const lifecycle = new Lifecycle();
83
- const { db, driver, close: closeDatabase, } = await createDb(mergedSchema, {
84
- ...config.database,
85
- dialect,
86
- introspect,
87
- });
88
- const email = createEmail(options.email, { env, db });
89
- if (closeDatabase)
90
- lifecycle.add(closeDatabase);
91
- try {
92
- // `db` is typed with the merged schema (user tables + internal tables) so the
93
- // storage/idempotency code can query the internal tables. The public surface
94
- // and CRUD only expose the USER schema. TS can widen the merged-schema db type
95
- // on its own (storage/auth pass `db` directly), but it can't *narrow* a
96
- // generic schema view, so this single intentional cast produces the
97
- // user-facing, per-dialect db type. See `app.db` / crud below.
98
- const userDb = db;
99
- // An `auth` builder gets the user-facing db, so better-auth hooks in another
100
- // file can write through the app's own connection without importing the app.
101
- const authConfig = resolveAuthConfig(config.auth, { db: userDb, env });
102
- const auth = createAuth(db, withEmailAuthDefaults(authConfig, email, Boolean(options.email)), dialect, options.schema);
103
- // Internal routers consume the narrow AuthSessionResolver contract, not the
104
- // raw better-auth instance. app.auth still exposes `auth` unchanged.
105
- const authResolver = options.authResolver ?? toAuthSessionResolver(auth);
106
- const resolvedAccess = validateAndResolveAccess(options.schema, options.access);
107
- const realtimeBufferSize = typeof config.realtime === 'object'
108
- ? config.realtime.bufferSize
109
- : undefined;
110
- const realtimeResumeSeconds = typeof config.realtime === 'object'
111
- ? config.realtime.resumeSeconds
112
- : undefined;
113
- const configuredRedisUrl = config.realtime
114
- ? resolveRealtimeRedisUrl(config.realtime, env)
115
- : undefined;
116
- const redisUrl = introspect ? undefined : configuredRedisUrl;
117
- const publisher = config.realtime
118
- ? redisUrl
119
- ? (() => {
120
- const redis = new Bun.RedisClient(redisUrl);
121
- const subscriber = redis.duplicate();
122
- lifecycle.add(async () => {
123
- redis.close();
124
- (await subscriber).close();
125
- });
126
- return createRedisRealtimePublisher(redis, subscriber, {
127
- prefix: process.env.BUNDERSTACK_REALTIME_PREFIX ?? 'bunderstack:',
128
- maxBufferedEvents: realtimeBufferSize,
129
- resumeSeconds: realtimeResumeSeconds,
130
- });
131
- })()
132
- : createMemoryRealtimePublisher({
133
- maxBufferedEvents: realtimeBufferSize,
134
- resumeSeconds: realtimeResumeSeconds,
135
- })
136
- : undefined;
137
- const runtimeRealtimeTransport = !publisher
138
- ? 'disabled'
139
- : redisUrl
140
- ? 'redis'
141
- : 'memory';
142
- const realtime = createRealtimeFacade(publisher, runtimeRealtimeTransport, options.schema);
143
- const registry = createBucketStorages(config.storage);
144
- const storageOperations = createStorageOperations({
145
- registry,
146
- db,
147
- });
148
- const storageApiRouter = buildStorageApiRouter(registry, storageOperations);
149
- const realtimeApiRouter = buildRealtimeApiRouter(publisher, resolvedAccess);
150
- const storage = {
151
- async delete(fileId) {
152
- const bucketName = fileId.split('/')[0] ?? '';
153
- const entry = registry.get(bucketName);
154
- if (entry) {
155
- await deleteFileWithDerivatives(entry.adapter, db, fileId);
156
- }
157
- else {
158
- // Unknown bucket: no adapter to clean, but still drop the meta row.
159
- await deleteFileMetaRow(db, fileId);
160
- }
161
- },
162
- bucket(name) {
163
- return registry.get(name)?.adapter;
164
- },
165
- sweep(olderThanMs = DEFAULT_PENDING_TTL_MS) {
166
- return sweepOrphans(registry, db, olderThanMs);
167
- },
168
- async getUrl(key, opts = {}) {
169
- const bucketName = opts.bucket ?? key.split('/')[0] ?? config.storage.defaultBucket;
170
- const adapter = registry.get(bucketName)?.adapter;
171
- if (adapter?.presignGet) {
172
- return adapter.presignGet(key, {
173
- expiresIn: opts.expiresIn ?? 3600,
174
- });
175
- }
176
- return `/api/files/${key}`;
177
- },
178
- async upload(key, body, contentType, opts = {}) {
179
- const bucketName = key.split('/')[0] ?? '';
180
- const adapter = registry.get(bucketName)?.adapter;
181
- if (!adapter)
182
- throw new Error(`Unknown bucket: ${bucketName}`);
183
- const u8 = body instanceof Uint8Array ? body : new Uint8Array(body);
184
- const buf = u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength);
185
- await adapter.upload(key, buf, contentType);
186
- await insertReadyFile(db, {
187
- fileId: key,
188
- bucket: bucketName,
189
- ownerId: opts.ownerId ?? null,
190
- scopeJson: null,
191
- filename: opts.filename ?? key.split('/').at(-1) ?? null,
192
- contentType,
193
- size: buf.byteLength,
194
- });
195
- },
196
- };
197
- const storageConfigured = Boolean(options.storage);
198
- // The storage sweep used to be a hardcoded maintenance route. It is an
199
- // ordinary cron now, so it inherits retries, timeout and onFailed.
200
- const resolvedDefs = storageConfigured
201
- ? {
202
- ...jobsDefs,
203
- 'bunderstack:storage-sweep': {
204
- kind: 'cron',
205
- schedule: '0 4 * * *',
206
- handler: async () => {
207
- await storage.sweep();
208
- },
209
- },
210
- }
211
- : jobsDefs;
212
- const jobRunner = resolvedDefs
213
- ? createJobRunner({
214
- db,
215
- defs: resolvedDefs,
216
- ctx: { db: userDb, env, email, storage, realtime },
217
- })
218
- : undefined;
219
- const jobs = {
220
- async enqueue(name, input, opts) {
221
- if (!resolvedDefs) {
222
- throw new Error('[bunderstack] no jobs configured — add a `jobs` key to createBunderstack');
223
- }
224
- const result = await enqueueJob(db, resolvedDefs, name, input, opts);
225
- return result;
226
- },
227
- tick(now) {
228
- return jobRunner
229
- ? jobRunner.tick(now)
230
- : Promise.resolve({ claimed: 0, ran: 0, failed: 0 });
231
- },
232
- };
233
- if (jobRunner)
234
- jobRunner.setJobsFacade(jobs);
235
- const startWorker = async (options = {}) => {
236
- if (introspect) {
237
- return { closed: Promise.resolve(), close: async () => { } };
238
- }
239
- if (!jobRunner) {
240
- throw new Error('[bunderstack] no queue jobs configured');
241
- }
242
- if (lifecycle.status !== 'ready') {
243
- throw new Error('[bunderstack] application lifecycle is closed');
244
- }
245
- const signal = options.signal
246
- ? AbortSignal.any([lifecycle.signal, options.signal])
247
- : lifecycle.signal;
248
- const handle = startJobWorker({
249
- ...options,
250
- signal,
251
- // The runtime loop only cares that a tick completed; TickResult is for
252
- // callers that invoke tick() directly.
253
- tick: async (now) => {
254
- await jobRunner.tick(now);
255
- },
256
- });
257
- const unregister = lifecycle.add(() => handle.close());
258
- void handle.closed.finally(unregister);
259
- return handle;
260
- };
261
- const runWorker = async (options = {}) => {
262
- if (introspect)
263
- return;
264
- if (realtime.transport === 'memory' &&
265
- !options.allowProcessLocalRealtime) {
266
- throw new Error('[bunderstack] runWorker() cannot deliver realtime events through the in-memory broker. Configure REDIS_URL or realtime.redis, embed the worker with startWorker(), or pass allowProcessLocalRealtime: true only when jobs never publish realtime.');
267
- }
268
- const { allowProcessLocalRealtime: _allowProcessLocalRealtime, ...workerOptions } = options;
269
- const handle = await startWorker(workerOptions);
270
- try {
271
- const signal = workerOptions.signal
272
- ? AbortSignal.any([lifecycle.signal, workerOptions.signal])
273
- : lifecycle.signal;
274
- await waitForWorkerShutdown(signal, !workerOptions.signal);
275
- }
276
- finally {
277
- await handle.close();
278
- await lifecycle.close();
279
- }
280
- };
281
- const crudApiRouter = buildCrudApiRouter(options.schema, userDb, {
282
- access: resolvedAccess,
283
- idempotency: options.idempotency,
284
- realtime,
285
- livePublisher: publisher,
286
- });
287
- const customApiRouter = typeof options.api === 'function'
288
- ? options.api(createApiBuilder())
289
- : options.api;
290
- const nativeRouter = buildApiRouter({
291
- crud: crudApiRouter,
292
- storage: storageApiRouter,
293
- realtime: realtimeApiRouter,
294
- custom: customApiRouter,
295
- middleware: options.middleware,
296
- });
297
- const authOpenAPISpecRaw = options.openapi &&
298
- auth.api &&
299
- 'generateOpenAPISchema' in auth.api &&
300
- typeof auth.api.generateOpenAPISchema === 'function'
301
- ? await auth.api.generateOpenAPISchema()
302
- : undefined;
303
- const authOpenAPISpec = authOpenAPISpecRaw
304
- ? normalizeForeignOpenAPISpec(authOpenAPISpecRaw, {
305
- prefix: '/api/auth',
306
- source: 'auth',
307
- })
308
- : undefined;
309
- await buildApiRegistry({
310
- nativeRouter,
311
- foreignSpecs: authOpenAPISpec ? [authOpenAPISpec] : [],
312
- reservedCoreHandles: new Set([
313
- 'health',
314
- ...(publisher ? ['realtime.changes'] : []),
315
- ...[...registry.keys()].flatMap((name) => [
316
- 'prepareUpload',
317
- 'upload',
318
- 'confirmUpload',
319
- 'download',
320
- 'delete',
321
- ].map((operation) => `files.${name}.${operation}`)),
322
- ]),
323
- });
324
- const valibotConverter = new ValibotToJsonSchemaConverter();
325
- const combinedOpenAPISpec = options.openapi
326
- ? mergeOpenAPISpecs({
327
- nativeSpec: await new OpenAPIGenerator({
328
- converters: [
329
- valibotConverter,
330
- {
331
- condition: (schema) => Boolean(schema?.['~standard'] && !schema['~standard'].jsonSchema),
332
- convert: (schema) => {
333
- const vendor = schema?.['~standard']?.vendor ?? 'unknown';
334
- throw new OpenAPIGeneratorError(`No JSON Schema converter is configured for Standard Schema vendor "${vendor}"`);
335
- },
336
- },
337
- ],
338
- }).generate(nativeRouter),
339
- authSpec: authOpenAPISpec,
340
- })
341
- : undefined;
342
- const openapiHandler = new OpenAPIHandler(nativeRouter, {
343
- // Query strings and form bodies are strings; this coerces them to the
344
- // types each procedure's input schema declares, so schemas stay honest
345
- // (`v.number()`, not a string-union pipe) and REST matches RPC.
346
- plugins: [
347
- new SmartCoercionHandlerPlugin({ converters: [valibotConverter] }),
348
- ],
349
- customErrorResponseBodyEncoder: (error) => {
350
- if (error?.code === 'INTERNAL_SERVER_ERROR' ||
351
- !error?.status ||
352
- error.status >= 500) {
353
- console.error('[bunderstack-api] 500 Internal Server Error:', error?.cause ?? error);
354
- }
355
- return {
356
- error: error.message,
357
- code: error.data?.code ?? error.code,
358
- // oRPC reports schema failures as `data.issues`; forwarding them tells
359
- // the client which field was rejected instead of just "invalid".
360
- ...(error.data?.details !== undefined
361
- ? { details: error.data.details }
362
- : error.data?.issues !== undefined
363
- ? { details: error.data.issues }
364
- : {}),
365
- };
366
- },
367
- fetchInterceptors: [
368
- async (options) => {
369
- const res = await options.next();
370
- if (res.matched && options.context.resHeaders) {
371
- options.context.resHeaders.forEach((v, k) => res.response.headers.set(k, v));
372
- }
373
- return res;
374
- },
375
- ],
376
- });
377
- // No custom error encoding here: the RPC protocol owns its error body, and
378
- // `mapBunderstackErrors` already logs unhandled procedure errors for every
379
- // transport before rethrowing them.
380
- const rpcHandler = new RPCHandler(nativeRouter);
381
- const apiHandler = async (req) => {
382
- const urlString = typeof req === 'string' ? req : req.url;
383
- if (!urlString)
384
- return null;
385
- const url = new URL(urlString, 'http://localhost');
386
- if (combinedOpenAPISpec &&
387
- url.pathname === '/api/openapi.json' &&
388
- req.method === 'GET') {
389
- return new Response(JSON.stringify(combinedOpenAPISpec), {
390
- headers: { 'Content-Type': 'application/json' },
391
- });
392
- }
393
- const apiCtx = createApiContext({
394
- db: userDb,
395
- env,
396
- storage,
397
- email,
398
- jobs,
399
- realtime,
400
- auth,
401
- authResolver,
402
- }, req);
403
- if (url.pathname.startsWith('/api/rpc')) {
404
- const res = await rpcHandler.handle(req, {
405
- prefix: '/api/rpc',
406
- context: apiCtx,
407
- });
408
- if (res.matched)
409
- return res.response;
410
- }
411
- const openapiRes = await openapiHandler.handle(req, { context: apiCtx });
412
- if (openapiRes.matched)
413
- return openapiRes.response;
414
- return null;
415
- };
416
- const handler = buildHandler({
417
- authHandler: (req) => auth.handler(req),
418
- apiHandler,
419
- rateLimit: options.rateLimit,
420
- });
421
- // Topology is a deployment concern: the role decides whether this process
422
- // runs background work, so application code never has to.
423
- const roleWantsWorker = env.BUNDERSTACK_ROLE === 'all' || env.BUNDERSTACK_ROLE === 'worker';
424
- const autoStart = options.background?.autoStart ??
425
- (roleWantsWorker && !introspect && resolvedDefs !== undefined);
426
- let backgroundRunning = false;
427
- if (autoStart) {
428
- await startWorker();
429
- backgroundRunning = true;
430
- }
431
- const app = {
432
- handler,
433
- // Internal tables live on the runtime db but stay out of the public type.
434
- db: userDb,
435
- auth,
436
- storage,
437
- env,
438
- email,
439
- realtime,
440
- // Runtime facade is untyped (JobsRuntimeFacade); the generic-typed field
441
- // narrows `enqueue` per-app from the declared job defs — same relationship
442
- // as `userDb` above.
443
- jobs: jobs,
444
- startWorker,
445
- runWorker,
446
- close: () => lifecycle.close(),
447
- backgroundRunning,
448
- get status() {
449
- return lifecycle.status;
450
- },
451
- signal: lifecycle.signal,
452
- manifest: buildManifest({
453
- schema: options.schema,
454
- dialect,
455
- migrationsDirectory: config.database.migrations,
456
- storage: config.storage,
457
- envConfig: options.env,
458
- emailProvider: emailProviderTag(options.email),
459
- realtime: Boolean(config.realtime),
460
- jobs: resolvedDefs,
461
- }),
462
- };
463
- app[PROVISION_INTERNALS] = {
464
- db,
465
- schema: mergedSchema,
466
- databaseUrl: config.database.url,
467
- migrationsFolder: config.database.migrations,
468
- dialect,
469
- driver,
470
- adapter: config.database.adapter,
471
- };
472
- return app;
473
- }
474
- catch (cause) {
475
- try {
476
- await lifecycle.close();
477
- }
478
- catch (cleanupCause) {
479
- throw new AggregateError([cause, cleanupCause], '[bunderstack] application initialization failed and cleanup failed');
480
- }
481
- throw cause;
482
- }
483
- }
1
+ export * from './backend.js';
484
2
  export { listSpec } from './api/list-spec.js';
485
3
  export { MAX_LIST_LIMIT } from './list-query.js';
486
4
  export { BunderstackError } from './errors.js';
@@ -491,7 +9,6 @@ export { createEmail } from './email.js';
491
9
  export { createJobsBuilder } from './jobs/index.js';
492
10
  export { defineAccess, validateAndResolveAccess, checkAccess, AUTH_TABLE_NAMES, } from './access.js';
493
11
  export { typeid, generate as generateTypeId, parse as parseTypeId, asTypeId, } from './typeid.js';
494
- export { mockAuthSession } from './testing.js';
495
12
  export { createRealtimeFacade } from './realtime/facade.js';
496
13
  export { createApiBuilder, defineApi } from './api/builder.js';
497
14
  export { buildApiRegistry, mergeApiRoutersStrict, normalizeApiPath, normalizeForeignOpenAPISpec, } from './api/registry.js';
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyRouter as AnyORPCRouter } from '@orpc/server'\n// src/index.ts\n\nimport { SmartCoercionHandlerPlugin } from '@orpc/json-schema'\nimport { OpenAPIGenerator, OpenAPIGeneratorError } from '@orpc/openapi'\nimport { OpenAPIHandler } from '@orpc/openapi/fetch'\nimport { RPCHandler } from '@orpc/server/fetch'\nimport { ValibotToJsonSchemaConverter } from '@orpc/valibot'\n\nimport type { TableAccessInput } from './access'\nimport type { BunderstackApiBuilder } from './api/builder'\nimport type { RealtimeApiRouter } from './api/realtime-router'\nimport type {\n CrudApiRouterFor,\n MergeApiRouterTypes,\n UnifiedApiRouter,\n} from './api/types'\nimport type { DbFor } from './db'\nimport type {\n BunderstackJobsBuilder,\n EnqueueOptions,\n JobsDefs,\n JobsFacade,\n StartWorkerOptions,\n WorkerHandle,\n} from './jobs/index'\nimport type { StorageConfigInput } from './storage/buckets'\nimport type { StorageAdapter } from './storage/index'\n\nimport { validateAndResolveAccess } from './access'\nimport { createApiBuilder } from './api/builder'\nimport { createApiContext } from './api/context'\nimport { buildCrudApiRouter } from './api/crud-router'\nimport { mergeOpenAPISpecs } from './api/openapi'\nimport { buildRealtimeApiRouter } from './api/realtime-router'\nimport { buildApiRegistry, normalizeForeignOpenAPISpec } from './api/registry'\nimport { buildApiRouter } from './api/router'\nimport { buildStorageApiRouter } from './api/storage-router'\nimport {\n createAuth,\n toAuthSessionResolver,\n withEmailAuthDefaults,\n} from './auth'\nimport { resolveConfig, type BunderstackConfig } from './config'\nimport { resolveAuthConfig, resolveRealtimeRedisUrl } from './config'\nimport { createDb } from './db'\nimport { detectDialect } from './dialect'\nimport { createEmail, emailProviderTag, type EmailFacade } from './email'\nimport { validateEnv, type EnvConfigInput, type ValidatedEnv } from './env'\nimport { buildHandler } from './handler'\nimport { withInternalTables } from './internal-tables'\nimport {\n createJobsBuilder,\n createJobRunner,\n enqueueJob,\n startJobWorker,\n validateJobsDefs,\n} from './jobs/index'\nimport { Lifecycle, type LifecycleStatus } from './lifecycle'\nimport { buildManifest, type BunderstackManifest } from './manifest'\nimport {\n PROVISION_INTERNALS,\n type WithProvisionInternals,\n} from './provision-internals'\nimport {\n createRealtimeFacade,\n type RealtimeFacade,\n type RealtimeTransport,\n} from './realtime/facade'\nimport {\n createMemoryRealtimePublisher,\n createRedisRealtimePublisher,\n} from './realtime/publisher'\nimport { deleteFileWithDerivatives } from './storage/delete'\nimport { deleteFileMetaRow, insertReadyFile } from './storage/file-meta'\nimport { createStorageOperations } from './storage/operations'\nimport { createBucketStorages } from './storage/registry'\nimport { sweepOrphans } from './storage/sweep'\n\nexport type AuthInstance = ReturnType<typeof createAuth>\n\nfunction waitForWorkerShutdown(\n signal: AbortSignal,\n installProcessListeners: boolean,\n): Promise<void> {\n if (signal.aborted) return Promise.resolve()\n\n return new Promise((resolve) => {\n const done = () => {\n signal.removeEventListener('abort', done)\n if (installProcessListeners) {\n process.removeListener('SIGINT', done)\n process.removeListener('SIGTERM', done)\n }\n resolve()\n }\n signal.addEventListener('abort', done, { once: true })\n if (installProcessListeners) {\n process.once('SIGINT', done)\n process.once('SIGTERM', done)\n }\n })\n}\n\n/** Default age before an unconfirmed `pending` file is treated as an orphan. */\nconst DEFAULT_PENDING_TTL_MS = 30 * 60_000\n/**\n * Public storage facade exposed as `app.storage`. Object-level operations live\n * on the per-bucket adapters; this surface offers the app-wide deletes that\n * must also clean the file-meta row.\n */\nexport interface StorageFacade {\n /** Delete a file row and purge all underlying storage derivatives. */\n delete(fileId: string): Promise<void>\n /** Low-level access to the underlying storage adapter for a bucket. */\n bucket(name: string): StorageAdapter | undefined\n /**\n * Reap stale `pending` uploads older than `olderThanMs` (default 30m). Runs\n * only when explicitly invoked by the host or local scheduler. Returns\n * the count reaped.\n */\n sweep(olderThanMs?: number): Promise<number>\n /**\n * Get a public or presigned download URL for a file key.\n * Returns a presigned S3 URL when S3 is configured, or local proxy route `/api/files/...` in development.\n */\n getUrl(\n key: string,\n opts?: { bucket?: string; expiresIn?: number },\n ): Promise<string>\n /**\n * Upload bytes as a ready file and register it in file_meta so it is\n * accessible via `GET /api/files/<key>`. Use this for server-generated\n * files (e.g. generated PDFs) that are not uploaded by end-users.\n */\n upload(\n key: string,\n body: ArrayBuffer | Uint8Array,\n contentType: string,\n opts?: { ownerId?: string; filename?: string },\n ): Promise<void>\n}\n\nexport type AppStartWorkerOptions = Omit<StartWorkerOptions, 'tick'>\nexport type AppRunWorkerOptions = AppStartWorkerOptions & {\n /**\n * Permit process-local realtime in a standalone worker.\n *\n * Use only when job handlers never call ctx.realtime.publish(). Publications\n * made through the memory broker cannot reach SSE clients in another process.\n */\n allowProcessLocalRealtime?: boolean\n}\n/** Bucket names declared in a storage config; `string` when unknowable. */\nexport type BucketNamesOf<TStorage> = TStorage extends {\n buckets: infer B extends Record<string, unknown>\n}\n ? keyof B & string\n : string\n\nexport type BunderstackApp<\n TSchema extends Record<string, unknown>,\n TAccess extends Record<string, TableAccessInput> | undefined = undefined,\n TBuckets extends string = string,\n TEnv extends EnvConfigInput | undefined = undefined,\n TJobsDefs extends JobsDefs | undefined = undefined,\n TCustomApiRouter extends AnyORPCRouter | undefined = undefined,\n TRealtime = undefined,\n> = {\n handler: (req: Request) => Promise<Response>\n db: DbFor<TSchema>\n auth: AuthInstance\n storage: StorageFacade\n /** Validated env: bunderstack's base vars plus the config's `env` extension. */\n env: ValidatedEnv<TEnv>\n /** Email facade; always present — send() throws when email isn't configured. */\n email: EmailFacade\n /** Job queue facade; always present — enqueue throws when jobs aren't configured. */\n jobs: JobsFacade<\n TJobsDefs extends JobsDefs ? TJobsDefs : Record<never, never>\n >\n /** Typed custom row publication; enabled=false/no-op when realtime is off. */\n realtime: RealtimeFacade<TSchema>\n startWorker(options?: AppStartWorkerOptions): Promise<WorkerHandle>\n /** Run a queue worker until aborted, then close the application. */\n runWorker(options?: AppRunWorkerOptions): Promise<void>\n close(): Promise<void>\n /** True when this process is running the background tick loop. */\n readonly backgroundRunning: boolean\n readonly status: LifecycleStatus\n readonly signal: AbortSignal\n /** Deploy-time introspection: what this app needs provisioned. */\n manifest: BunderstackManifest\n /**\n * Type-only carrier for client inference (`createClient<typeof app>()`).\n * Never assigned at runtime.\n */\n readonly $inferClient?: {\n schema: TSchema\n access: TAccess\n buckets: TBuckets\n api: MergeApiRouterTypes<\n UnifiedApiRouter<\n CrudApiRouterFor<\n TSchema,\n TAccess,\n [TRealtime] extends [false | undefined] ? false : true\n >,\n TCustomApiRouter\n >,\n [TRealtime] extends [false | undefined] ? {} : RealtimeApiRouter\n >\n }\n}\n\nexport function createBunderstack<\n TSchema extends Record<string, unknown>,\n const TAccess extends Record<string, TableAccessInput> | undefined =\n undefined,\n const TStorage extends StorageConfigInput | undefined = undefined,\n const TEnv extends EnvConfigInput | undefined = undefined,\n const TJobsDefs extends JobsDefs | undefined = undefined,\n TCustomApiRouter extends AnyORPCRouter | undefined = undefined,\n const TRealtime extends BunderstackConfig<\n TSchema,\n TAccess,\n TStorage,\n TEnv,\n TCustomApiRouter\n >['realtime'] = undefined,\n>(\n options: BunderstackConfig<\n TSchema,\n TAccess,\n TStorage,\n TEnv,\n TCustomApiRouter\n > & {\n realtime?: TRealtime\n jobs?:\n | TJobsDefs\n | ((j: BunderstackJobsBuilder<TSchema, ValidatedEnv<TEnv>>) => TJobsDefs)\n },\n): Promise<\n BunderstackApp<\n TSchema,\n TAccess,\n BucketNamesOf<TStorage>,\n TEnv,\n TJobsDefs,\n TCustomApiRouter,\n TRealtime\n >\n>\nexport async function createBunderstack<\n TSchema extends Record<string, unknown>,\n const TAccess extends Record<string, TableAccessInput> | undefined =\n undefined,\n const TStorage extends StorageConfigInput | undefined = undefined,\n const TEnv extends EnvConfigInput | undefined = undefined,\n TCustomApiRouter extends AnyORPCRouter | undefined = undefined,\n const TRealtime extends BunderstackConfig<\n TSchema,\n TAccess,\n TStorage,\n TEnv,\n TCustomApiRouter\n >['realtime'] = undefined,\n>(\n options: BunderstackConfig<\n TSchema,\n TAccess,\n TStorage,\n TEnv,\n TCustomApiRouter\n > & {\n realtime?: TRealtime\n jobs?:\n | JobsDefs\n | ((j: BunderstackJobsBuilder<TSchema, ValidatedEnv<TEnv>>) => JobsDefs)\n },\n): Promise<\n BunderstackApp<\n TSchema,\n TAccess,\n BucketNamesOf<TStorage>,\n TEnv,\n JobsDefs | undefined,\n TCustomApiRouter,\n TRealtime\n >\n> {\n const dialect = detectDialect(options.schema)\n const jobsDefs: JobsDefs | undefined = options.jobs\n ? typeof options.jobs === 'function'\n ? options.jobs(createJobsBuilder<TSchema, ValidatedEnv<TEnv>>())\n : (options.jobs as JobsDefs)\n : undefined\n if (jobsDefs) validateJobsDefs(jobsDefs)\n // Env is validated FIRST: the app refuses to boot on missing/invalid vars,\n // and everything downstream consumes the result.\n const env = validateEnv(options.env, {\n emailProvider:\n options.processEnv?.BUNDERSTACK_EMAIL_PROVIDER ??\n emailProviderTag(options.email),\n defaultDatabaseUrl:\n dialect === 'pg' ? 'file:./data.pglite' : 'file:./data.db',\n source: options.processEnv,\n })\n const config = resolveConfig(options, env, options.processEnv)\n // Adapters use Drizzle mocks during deployment introspection, so the database\n // and Redis below never touch external services.\n const introspect = process.env.BUNDERSTACK_INTROSPECT === '1'\n // Merge bunderstack's internal tables (file-meta, idempotency) into the\n // schema used for the db client + provisioning. CRUD/access stay on the USER\n // schema so internal tables never get a CRUD route.\n const mergedSchema = withInternalTables(options.schema)\n const lifecycle = new Lifecycle()\n const {\n db,\n driver,\n close: closeDatabase,\n } = await createDb(mergedSchema, {\n ...config.database,\n dialect,\n introspect,\n })\n const email = createEmail(options.email, { env, db })\n if (closeDatabase) lifecycle.add(closeDatabase)\n try {\n // `db` is typed with the merged schema (user tables + internal tables) so the\n // storage/idempotency code can query the internal tables. The public surface\n // and CRUD only expose the USER schema. TS can widen the merged-schema db type\n // on its own (storage/auth pass `db` directly), but it can't *narrow* a\n // generic schema view, so this single intentional cast produces the\n // user-facing, per-dialect db type. See `app.db` / crud below.\n const userDb = db as unknown as DbFor<TSchema>\n // An `auth` builder gets the user-facing db, so better-auth hooks in another\n // file can write through the app's own connection without importing the app.\n const authConfig = resolveAuthConfig(config.auth, { db: userDb, env })\n const auth = createAuth(\n db,\n withEmailAuthDefaults(authConfig, email, Boolean(options.email)),\n dialect,\n options.schema as Record<string, unknown>,\n )\n // Internal routers consume the narrow AuthSessionResolver contract, not the\n // raw better-auth instance. app.auth still exposes `auth` unchanged.\n const authResolver = options.authResolver ?? toAuthSessionResolver(auth)\n const resolvedAccess = validateAndResolveAccess(\n options.schema,\n options.access,\n )\n const realtimeBufferSize =\n typeof config.realtime === 'object'\n ? config.realtime.bufferSize\n : undefined\n const realtimeResumeSeconds =\n typeof config.realtime === 'object'\n ? config.realtime.resumeSeconds\n : undefined\n const configuredRedisUrl = config.realtime\n ? resolveRealtimeRedisUrl(config.realtime, env)\n : undefined\n const redisUrl = introspect ? undefined : configuredRedisUrl\n const publisher = config.realtime\n ? redisUrl\n ? (() => {\n const redis = new Bun.RedisClient(redisUrl)\n const subscriber = redis.duplicate()\n lifecycle.add(async () => {\n redis.close()\n ;(await subscriber).close()\n })\n return createRedisRealtimePublisher(redis, subscriber, {\n prefix: process.env.BUNDERSTACK_REALTIME_PREFIX ?? 'bunderstack:',\n maxBufferedEvents: realtimeBufferSize,\n resumeSeconds: realtimeResumeSeconds,\n })\n })()\n : createMemoryRealtimePublisher({\n maxBufferedEvents: realtimeBufferSize,\n resumeSeconds: realtimeResumeSeconds,\n })\n : undefined\n const runtimeRealtimeTransport: RealtimeTransport = !publisher\n ? 'disabled'\n : redisUrl\n ? 'redis'\n : 'memory'\n const realtime = createRealtimeFacade<TSchema>(\n publisher,\n runtimeRealtimeTransport,\n options.schema,\n )\n const registry = createBucketStorages(config.storage)\n const storageOperations = createStorageOperations({\n registry,\n db,\n })\n const storageApiRouter = buildStorageApiRouter(registry, storageOperations)\n const realtimeApiRouter = buildRealtimeApiRouter(publisher, resolvedAccess)\n const storage: StorageFacade = {\n async delete(fileId) {\n const bucketName = fileId.split('/')[0] ?? ''\n const entry = registry.get(bucketName)\n if (entry) {\n await deleteFileWithDerivatives(entry.adapter, db, fileId)\n } else {\n // Unknown bucket: no adapter to clean, but still drop the meta row.\n await deleteFileMetaRow(db, fileId)\n }\n },\n bucket(name) {\n return registry.get(name)?.adapter\n },\n sweep(olderThanMs = DEFAULT_PENDING_TTL_MS) {\n return sweepOrphans(registry, db, olderThanMs)\n },\n async getUrl(key, opts = {}) {\n const bucketName =\n opts.bucket ?? key.split('/')[0] ?? config.storage.defaultBucket\n const adapter = registry.get(bucketName)?.adapter\n if (adapter?.presignGet) {\n return adapter.presignGet(key, {\n expiresIn: opts.expiresIn ?? 3600,\n })\n }\n return `/api/files/${key}`\n },\n async upload(key, body, contentType, opts = {}) {\n const bucketName = key.split('/')[0] ?? ''\n const adapter = registry.get(bucketName)?.adapter\n if (!adapter) throw new Error(`Unknown bucket: ${bucketName}`)\n const u8 = body instanceof Uint8Array ? body : new Uint8Array(body)\n const buf: ArrayBuffer = u8.buffer.slice(\n u8.byteOffset,\n u8.byteOffset + u8.byteLength,\n ) as ArrayBuffer\n await adapter.upload(key, buf, contentType)\n await insertReadyFile(db, {\n fileId: key,\n bucket: bucketName,\n ownerId: opts.ownerId ?? null,\n scopeJson: null,\n filename: opts.filename ?? key.split('/').at(-1) ?? null,\n contentType,\n size: buf.byteLength,\n })\n },\n }\n const storageConfigured = Boolean(options.storage)\n // The storage sweep used to be a hardcoded maintenance route. It is an\n // ordinary cron now, so it inherits retries, timeout and onFailed.\n const resolvedDefs: JobsDefs | undefined = storageConfigured\n ? {\n ...jobsDefs,\n 'bunderstack:storage-sweep': {\n kind: 'cron',\n schedule: '0 4 * * *',\n handler: async () => {\n await storage.sweep()\n },\n },\n }\n : jobsDefs\n\n const jobRunner = resolvedDefs\n ? createJobRunner({\n db,\n defs: resolvedDefs,\n ctx: { db: userDb, env, email, storage, realtime },\n })\n : undefined\n const jobs = {\n async enqueue(name: string, input?: unknown, opts?: EnqueueOptions) {\n if (!resolvedDefs) {\n throw new Error(\n '[bunderstack] no jobs configured — add a `jobs` key to createBunderstack',\n )\n }\n const result = await enqueueJob(db, resolvedDefs, name, input, opts)\n return result\n },\n tick(now?: number) {\n return jobRunner\n ? jobRunner.tick(now)\n : Promise.resolve({ claimed: 0, ran: 0, failed: 0 })\n },\n }\n if (jobRunner) jobRunner.setJobsFacade(jobs)\n const startWorker = async (\n options: AppStartWorkerOptions = {},\n ): Promise<WorkerHandle> => {\n if (introspect) {\n return { closed: Promise.resolve(), close: async () => {} }\n }\n if (!jobRunner) {\n throw new Error('[bunderstack] no queue jobs configured')\n }\n if (lifecycle.status !== 'ready') {\n throw new Error('[bunderstack] application lifecycle is closed')\n }\n const signal = options.signal\n ? AbortSignal.any([lifecycle.signal, options.signal])\n : lifecycle.signal\n const handle = startJobWorker({\n ...options,\n signal,\n // The runtime loop only cares that a tick completed; TickResult is for\n // callers that invoke tick() directly.\n tick: async (now) => {\n await jobRunner.tick(now)\n },\n })\n const unregister = lifecycle.add(() => handle.close())\n void handle.closed.finally(unregister)\n return handle\n }\n const runWorker = async (\n options: AppRunWorkerOptions = {},\n ): Promise<void> => {\n if (introspect) return\n if (\n realtime.transport === 'memory' &&\n !options.allowProcessLocalRealtime\n ) {\n throw new Error(\n '[bunderstack] runWorker() cannot deliver realtime events through the in-memory broker. Configure REDIS_URL or realtime.redis, embed the worker with startWorker(), or pass allowProcessLocalRealtime: true only when jobs never publish realtime.',\n )\n }\n const {\n allowProcessLocalRealtime: _allowProcessLocalRealtime,\n ...workerOptions\n } = options\n const handle = await startWorker(workerOptions)\n try {\n const signal = workerOptions.signal\n ? AbortSignal.any([lifecycle.signal, workerOptions.signal])\n : lifecycle.signal\n await waitForWorkerShutdown(signal, !workerOptions.signal)\n } finally {\n await handle.close()\n await lifecycle.close()\n }\n }\n const crudApiRouter = buildCrudApiRouter<\n TSchema,\n TAccess,\n [TRealtime] extends [false | undefined] ? false : true\n >(options.schema, userDb, {\n access: resolvedAccess,\n idempotency: options.idempotency,\n realtime,\n livePublisher: publisher,\n })\n\n const customApiRouter =\n typeof options.api === 'function'\n ? (\n options.api as (\n builder: BunderstackApiBuilder<TSchema, ValidatedEnv<TEnv>>,\n ) => TCustomApiRouter\n )(createApiBuilder<TSchema, ValidatedEnv<TEnv>>())\n : options.api\n\n const nativeRouter = buildApiRouter({\n crud: crudApiRouter as Record<string, unknown>,\n storage: storageApiRouter as Record<string, unknown>,\n realtime: realtimeApiRouter as Record<string, unknown> | undefined,\n custom: customApiRouter as Record<string, unknown> | undefined,\n middleware: options.middleware,\n }) as any\n\n const authOpenAPISpecRaw =\n options.openapi &&\n auth.api &&\n 'generateOpenAPISchema' in auth.api &&\n typeof auth.api.generateOpenAPISchema === 'function'\n ? await auth.api.generateOpenAPISchema()\n : undefined\n\n const authOpenAPISpec = authOpenAPISpecRaw\n ? normalizeForeignOpenAPISpec(authOpenAPISpecRaw, {\n prefix: '/api/auth',\n source: 'auth',\n })\n : undefined\n\n await buildApiRegistry({\n nativeRouter,\n foreignSpecs: authOpenAPISpec ? [authOpenAPISpec] : [],\n reservedCoreHandles: new Set([\n 'health',\n ...(publisher ? ['realtime.changes'] : []),\n ...[...registry.keys()].flatMap((name) =>\n [\n 'prepareUpload',\n 'upload',\n 'confirmUpload',\n 'download',\n 'delete',\n ].map((operation) => `files.${name}.${operation}`),\n ),\n ]),\n })\n\n const valibotConverter = new ValibotToJsonSchemaConverter()\n\n const combinedOpenAPISpec = options.openapi\n ? mergeOpenAPISpecs({\n nativeSpec: await new OpenAPIGenerator({\n converters: [\n valibotConverter,\n {\n condition: (schema: any) =>\n Boolean(\n schema?.['~standard'] && !schema['~standard'].jsonSchema,\n ),\n convert: (schema: any) => {\n const vendor = schema?.['~standard']?.vendor ?? 'unknown'\n throw new OpenAPIGeneratorError(\n `No JSON Schema converter is configured for Standard Schema vendor \"${vendor}\"`,\n )\n },\n },\n ],\n }).generate(nativeRouter),\n authSpec: authOpenAPISpec,\n })\n : undefined\n\n const openapiHandler = new OpenAPIHandler(nativeRouter, {\n // Query strings and form bodies are strings; this coerces them to the\n // types each procedure's input schema declares, so schemas stay honest\n // (`v.number()`, not a string-union pipe) and REST matches RPC.\n plugins: [\n new SmartCoercionHandlerPlugin({ converters: [valibotConverter] }),\n ],\n customErrorResponseBodyEncoder: (error: any) => {\n if (\n error?.code === 'INTERNAL_SERVER_ERROR' ||\n !error?.status ||\n error.status >= 500\n ) {\n console.error(\n '[bunderstack-api] 500 Internal Server Error:',\n error?.cause ?? error,\n )\n }\n return {\n error: error.message,\n code: error.data?.code ?? error.code,\n // oRPC reports schema failures as `data.issues`; forwarding them tells\n // the client which field was rejected instead of just \"invalid\".\n ...(error.data?.details !== undefined\n ? { details: error.data.details }\n : error.data?.issues !== undefined\n ? { details: error.data.issues }\n : {}),\n }\n },\n fetchInterceptors: [\n async (options) => {\n const res = await options.next()\n if (res.matched && options.context.resHeaders) {\n options.context.resHeaders.forEach((v: string, k: string) =>\n res.response.headers.set(k, v),\n )\n }\n return res\n },\n ],\n })\n // No custom error encoding here: the RPC protocol owns its error body, and\n // `mapBunderstackErrors` already logs unhandled procedure errors for every\n // transport before rethrowing them.\n const rpcHandler = new RPCHandler(nativeRouter)\n\n const apiHandler = async (req: Request): Promise<Response | null> => {\n const urlString = typeof req === 'string' ? (req as string) : req.url\n if (!urlString) return null\n const url = new URL(urlString, 'http://localhost')\n if (\n combinedOpenAPISpec &&\n url.pathname === '/api/openapi.json' &&\n req.method === 'GET'\n ) {\n return new Response(JSON.stringify(combinedOpenAPISpec), {\n headers: { 'Content-Type': 'application/json' },\n })\n }\n\n const apiCtx = createApiContext(\n {\n db: userDb,\n env,\n storage,\n email,\n jobs,\n realtime,\n auth,\n authResolver,\n },\n req,\n )\n\n if (url.pathname.startsWith('/api/rpc')) {\n const res = await rpcHandler.handle(req, {\n prefix: '/api/rpc',\n context: apiCtx,\n })\n if (res.matched) return res.response\n }\n\n const openapiRes = await openapiHandler.handle(req, { context: apiCtx })\n if (openapiRes.matched) return openapiRes.response\n\n return null\n }\n\n const handler = buildHandler({\n authHandler: (req) => auth.handler(req),\n apiHandler,\n rateLimit: options.rateLimit,\n })\n\n // Topology is a deployment concern: the role decides whether this process\n // runs background work, so application code never has to.\n const roleWantsWorker =\n env.BUNDERSTACK_ROLE === 'all' || env.BUNDERSTACK_ROLE === 'worker'\n const autoStart =\n options.background?.autoStart ??\n (roleWantsWorker && !introspect && resolvedDefs !== undefined)\n let backgroundRunning = false\n if (autoStart) {\n await startWorker()\n backgroundRunning = true\n }\n\n const app: BunderstackApp<\n TSchema,\n TAccess,\n BucketNamesOf<TStorage>,\n TEnv,\n JobsDefs | undefined,\n TCustomApiRouter,\n TRealtime\n > = {\n handler,\n // Internal tables live on the runtime db but stay out of the public type.\n db: userDb,\n auth,\n storage,\n env,\n email,\n realtime,\n // Runtime facade is untyped (JobsRuntimeFacade); the generic-typed field\n // narrows `enqueue` per-app from the declared job defs — same relationship\n // as `userDb` above.\n jobs: jobs as never,\n startWorker,\n runWorker,\n close: () => lifecycle.close(),\n backgroundRunning,\n get status() {\n return lifecycle.status\n },\n signal: lifecycle.signal,\n manifest: buildManifest({\n schema: options.schema,\n dialect,\n migrationsDirectory: config.database.migrations,\n storage: config.storage,\n envConfig: options.env as EnvConfigInput | undefined,\n emailProvider: emailProviderTag(options.email),\n realtime: Boolean(config.realtime),\n jobs: resolvedDefs,\n }),\n }\n\n // Hidden handle for the optional `bunderstack/provision` entry. Kept off the\n // public type so provisioning stays opt-in (and drizzle-kit out of this\n // module graph).\n ;(app as WithProvisionInternals)[PROVISION_INTERNALS] = {\n db,\n schema: mergedSchema,\n databaseUrl: config.database.url,\n migrationsFolder: config.database.migrations,\n dialect,\n driver,\n adapter: config.database.adapter,\n }\n\n return app\n } catch (cause) {\n try {\n await lifecycle.close()\n } catch (cleanupCause) {\n throw new AggregateError(\n [cause, cleanupCause],\n '[bunderstack] application initialization failed and cleanup failed',\n )\n }\n throw cause\n }\n}\n\nexport { listSpec } from './api/list-spec'\nexport type { ListSpecOptions } from './api/list-spec'\nexport type { BunderstackDb, BunderstackTx } from './db'\nexport { MAX_LIST_LIMIT } from './list-query'\nexport { BunderstackError } from './errors'\nexport type { BunderstackErrorCode } from './errors'\nexport { resolveConfig, resolveAuthConfig, defineAuth } from './config'\nexport type {\n AuthConfigContext,\n AuthConfigFactory,\n AuthConfigInput,\n BetterAuthConfig,\n BunderstackConfig,\n ResolvedConfig,\n} from './config'\nexport { validateEnv, createClientEnv, BunderstackEnvError } from './env'\nexport type { EnvConfigInput, BaseEnv, ValidatedEnv } from './env'\nexport { buildManifest, parseManifest } from './manifest'\nexport type { BunderstackManifest, ManifestEnvVar } from './manifest'\nexport { createEmail } from './email'\nexport type {\n EmailMessage,\n EmailAdapter,\n EmailConfigInput,\n EmailFacade,\n} from './email'\nexport { createJobsBuilder } from './jobs/index'\nexport type {\n BunderstackJobContext,\n BunderstackJobsBuilder,\n BackgroundDefinition,\n BackgroundDefs,\n CronDefinition,\n CronInvocation,\n EnqueueOptions,\n JobContext,\n JobDefinition,\n JobsDefs,\n JobsFacade,\n JobsRuntimeFacade,\n QueueJobDefinition,\n QueueJobKeys,\n RunWorkerOptions,\n StartWorkerOptions,\n WorkerHandle,\n} from './jobs/index'\nexport {\n defineAccess,\n validateAndResolveAccess,\n checkAccess,\n AUTH_TABLE_NAMES,\n} from './access'\nexport type {\n TableAccessInput,\n OperationRule,\n AccessContext,\n AccessUser,\n} from './access'\nexport {\n typeid,\n generate as generateTypeId,\n parse as parseTypeId,\n asTypeId,\n} from './typeid'\nexport type { TypeId } from './typeid'\nexport type {\n DatabaseAdapter,\n DatabaseConnectOptions,\n DatabaseConnection,\n DatabaseConnectionResult,\n} from './database/adapter'\nexport type { StorageAdapter } from './storage/index'\nexport type {\n StorageConfigInput,\n BucketConfigInput,\n ResolvedBucket,\n} from './storage/buckets'\n// StorageFacade is declared+exported inline above.\nexport type { TransformSpec } from './storage/thumbnails'\nexport { mockAuthSession } from './testing'\n\nexport type { RealtimeAction } from './realtime/publisher'\nexport { createRealtimeFacade } from './realtime/facade'\nexport type {\n RealtimeFacade,\n RealtimeTransport,\n SchemaTable,\n} from './realtime/facade'\n\nexport { createApiBuilder, defineApi } from './api/builder'\nexport type { BunderstackApiBuilder, ApiFactory } from './api/builder'\n// Needed to declare shared middleware over the app's context, e.g.\n// `os.$context<ApiContext<typeof schema>>().middleware(...)`.\nexport type { ApiContext } from './api/context'\nexport type {\n CrudApiRouterFor,\n ExposedApiTables,\n MergeApiRouterTypes,\n UnifiedApiRouter,\n} from './api/types'\nexport type { TableCrudProcedures } from './api/crud-router'\nexport {\n buildApiRegistry,\n mergeApiRoutersStrict,\n normalizeApiPath,\n normalizeForeignOpenAPISpec,\n} from './api/registry'\nexport { mergeOpenAPISpecs } from './api/openapi'\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AASzB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAG1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE3C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AASvE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAEzE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAOrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAoBhD,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,WAAW,EACX,gBAAgB,GACjB,MAAM,UAAU,CAAA;AAOjB,OAAO,EACL,MAAM,EACN,QAAQ,IAAI,cAAc,EAC1B,KAAK,IAAI,WAAW,EACpB,QAAQ,GACT,MAAM,UAAU,CAAA;AAejB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAMxD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAU3D,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA","sourcesContent":["export * from './backend'\nexport type {\n AppRunWorkerOptions,\n AppStartWorkerOptions,\n AuthInstance,\n BucketNamesOf,\n BunderstackApp,\n StorageFacade,\n} from './runtime'\nexport { listSpec } from './api/list-spec'\nexport type { ListSpecOptions } from './api/list-spec'\nexport type { BunderstackDb, BunderstackTx } from './db'\nexport { MAX_LIST_LIMIT } from './list-query'\nexport { BunderstackError } from './errors'\nexport type { BunderstackErrorCode } from './errors'\nexport { resolveConfig, resolveAuthConfig, defineAuth } from './config'\nexport type {\n AuthConfigContext,\n AuthConfigFactory,\n AuthConfigInput,\n BetterAuthConfig,\n BunderstackConfig,\n ResolvedConfig,\n} from './config'\nexport { validateEnv, createClientEnv, BunderstackEnvError } from './env'\nexport type { EnvConfigInput, BaseEnv, ValidatedEnv } from './env'\nexport { buildManifest, parseManifest } from './manifest'\nexport type { BunderstackManifest, ManifestEnvVar } from './manifest'\nexport { createEmail } from './email'\nexport type {\n EmailMessage,\n EmailAdapter,\n EmailConfigInput,\n EmailFacade,\n} from './email'\nexport { createJobsBuilder } from './jobs/index'\nexport type {\n BunderstackJobContext,\n BunderstackJobsBuilder,\n BackgroundDefinition,\n BackgroundDefs,\n CronDefinition,\n CronInvocation,\n EnqueueOptions,\n JobContext,\n JobDefinition,\n JobsDefs,\n JobsFacade,\n JobsRuntimeFacade,\n QueueJobDefinition,\n QueueJobKeys,\n RunWorkerOptions,\n StartWorkerOptions,\n WorkerHandle,\n} from './jobs/index'\nexport {\n defineAccess,\n validateAndResolveAccess,\n checkAccess,\n AUTH_TABLE_NAMES,\n} from './access'\nexport type {\n TableAccessInput,\n OperationRule,\n AccessContext,\n AccessUser,\n} from './access'\nexport {\n typeid,\n generate as generateTypeId,\n parse as parseTypeId,\n asTypeId,\n} from './typeid'\nexport type { TypeId } from './typeid'\nexport type {\n DatabaseAdapter,\n DatabaseConnection,\n DatabaseConnectionResult,\n} from './database/adapter'\nexport type { StorageAdapter } from './storage/index'\nexport type {\n StorageConfigInput,\n BucketConfigInput,\n ResolvedBucket,\n} from './storage/buckets'\nexport type { TransformSpec } from './storage/thumbnails'\nexport type { RealtimeAction } from './realtime/publisher'\nexport { createRealtimeFacade } from './realtime/facade'\nexport type {\n RealtimeFacade,\n RealtimeTransport,\n SchemaTable,\n} from './realtime/facade'\nexport { createApiBuilder, defineApi } from './api/builder'\nexport type { BunderstackApiBuilder, ApiFactory } from './api/builder'\nexport type { ApiContext } from './api/context'\nexport type {\n CrudApiRouterFor,\n ExposedApiTables,\n MergeApiRouterTypes,\n UnifiedApiRouter,\n} from './api/types'\nexport type { TableCrudProcedures } from './api/crud-router'\nexport {\n buildApiRegistry,\n mergeApiRoutersStrict,\n normalizeApiPath,\n normalizeForeignOpenAPISpec,\n} from './api/registry'\nexport { mergeOpenAPISpecs } from './api/openapi'\n"]}
@@ -1,7 +1,7 @@
1
1
  import type { StandardSchemaV1 } from '@standard-schema/spec';
2
2
  import type { DbFor } from '../db.js';
3
3
  import type { EmailFacade } from '../email.js';
4
- import type { StorageFacade } from '../index.js';
4
+ import type { StorageFacade } from '../runtime.js';
5
5
  import { type CatchUp } from './slots.js';
6
6
  export declare const DEFAULT_RETRIES = 3;
7
7
  export declare const DEFAULT_TIMEOUT_MS = 60000;