@flowdular/sdk 0.1.0 → 0.2.1

package/.ai/skills/test-hardening/SKILL.md

@@ -18,7 +18,7 @@ when: A module has few or tautological tests, a bug escaped the suite, or a revi
 
 - `tests/module.test.ts` (one file per module today; more files are fine). `tsconfig.json` includes `src/**/*` and `tests/**/*.ts`, so a test file is `.ts`; `.tsrx` components are not compiled by vitest here. Testable client logic (formatting, filtering, mapping, state transitions) goes into a `.ts` helper next to the view and is imported by the test.
 - Runner: `vitest run` (`pnpm --filter @flowdular/module-<dir> test`). In the sandbox the `tests` gate runs `vitest run --passWithNoTests` inside the module directory, so a module with no tests passes the gate. Treat an empty or trivial suite as a defect, not a pass.
-- Pinned: vitest 4.1.10, typescript 5.9.3, `@types/node` 24.13.3 (`.ai/references/catalog/package.json`).
+- New modules use vitest 4.1.11, typescript 5.9.3 and `@types/node` 24.13.3. The catalog reference is an immutable older release; use the current scaffold dependency versions for new code.
 
 ## 2. Repositories on an embedded PostgreSQL
 

package/README.md

@@ -1,24 +1,81 @@
+[![Flowdular: Build your business platform](https://cdn.jsdelivr.net/npm/@flowdular/sdk@latest/assets/flowdular-banner.png)](https://flowdular.com)
+
 # Flowdular SDK
 
-One npm package for the Flowdular platform. Import the surface you need:
+[![npm version](https://img.shields.io/npm/v/@flowdular/sdk?color=f59e0b)](https://www.npmjs.com/package/@flowdular/sdk)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D22.22.2-339933?logo=nodedotjs&logoColor=white)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/Flowdular/flowdular/blob/main/LICENSE)
+
+The shared foundation for Flowdular applications: server APIs, client integration, UI components, databases, agents and bundled core modules. Build business modules against one SDK with explicit imports for each part of the platform.
+
+## Start a new application
+
+Use Node.js **22.22.2 or newer**. The generated workspace uses pnpm.
+
+```sh
+npm create flowdular@latest my-app
+cd my-app
+pnpm flowdular doctor
+```
+
+The generator configures the SDK and the Flowdular/Octane build toolchain. To add the SDK to an existing compatible workspace, install it in the package that imports it:
+
+```sh
+pnpm add @flowdular/sdk
+```
+
+## Import what you need
 
 ```ts
+// Server-side module code
 import { defineEndpoint } from '@flowdular/sdk/server';
 import type { ModuleManifest } from '@flowdular/sdk/contracts';
+```
+
+```ts
+// Client-side module code
 import { Button } from '@flowdular/sdk/ui';
 import '@flowdular/sdk/ui/styles';
 ```
 
-Exports include `client`, `server`, `ui`, `contracts`, `kernel`, `database`,
-`database-pglite`, `database-testing`, `harness`, `ai-provider`, `coding-agent`,
-`cli-protocol`, `dev-console`, `sandbox` and `modules/<name>` for bundled core modules.
-Subpaths retain their own exports, such as `modules/auth/server` and `client/i18n`.
-There is no root barrel importing server code into browser entrypoints.
+The SDK ships TypeScript and TSRX source for the Flowdular/Octane toolchain. It has no root import. Keep server and database imports in server code; use client and UI entrypoints in browser code.
+
+## What's included
+
+| Area                                    | Import paths                                                     |
+| --------------------------------------- | ---------------------------------------------------------------- |
+| Module contracts and runtime            | `@flowdular/sdk/contracts`, `@flowdular/sdk/kernel`              |
+| HTTP endpoints                          | `@flowdular/sdk/server`                                          |
+| Client integration and translations     | `@flowdular/sdk/client`, `@flowdular/sdk/client/i18n`            |
+| Shared UI and styles                    | `@flowdular/sdk/ui`, `@flowdular/sdk/ui/styles`                  |
+| Database contracts and local PostgreSQL | `@flowdular/sdk/database`, `@flowdular/sdk/database-pglite`      |
+| Database test helpers                   | `@flowdular/sdk/database-testing`                                |
+| Agents and providers                    | `@flowdular/sdk/harness`, `@flowdular/sdk/ai-provider`           |
+| Development APIs                        | `@flowdular/sdk/dev-console`, `@flowdular/sdk/cli-protocol`      |
+| Bundled core modules                    | `@flowdular/sdk/modules/<name>`, including `modules/auth/server` |
+
+Business modules are distributed as source archives through [Official Modules](https://github.com/Flowdular/official-modules). Installing an archive and enabling a module are separate CLI actions.
+
+The coding sandbox is a separate application distributed as `@flowdular/sandbox`.
+Launch it with `npx @flowdular/sandbox` from your application directory. It depends
+on the SDK; installing the SDK alone does not install the sandbox application or
+its launcher. The SDK's `modules/sandbox` export is the platform access/grant
+module, not the coding application.
+
+## Build a module
+
+Use explicit permissions for endpoints, tenant-bound database access and the shared UI components. Run the generated workspace's checks before delivery:
+
+```sh
+pnpm verify
+```
+
+See the [module guide](https://github.com/Flowdular/flowdular/blob/main/docs/modules.md), [database adapters](https://github.com/Flowdular/flowdular/blob/main/docs/database-adapters.md) and [design system](https://github.com/Flowdular/flowdular/blob/main/docs/design-system.md).
+
+## Packages and support
 
-The SDK ships TypeScript and TSRX source for the Flowdular/Octane build toolchain.
-Create a configured workspace with `npm create flowdular@latest my-app`.
-The CLI is published separately as `flowdular`.
+- [flowdular](https://www.npmjs.com/package/flowdular): workspace CLI.
+- [create-flowdular](https://www.npmjs.com/package/create-flowdular): application generator.
+- [Documentation](https://github.com/Flowdular/flowdular/tree/main/docs) · [Source and issues](https://github.com/Flowdular/flowdular) · [Website](https://flowdular.com)
 
-Source packages remain separate private workspaces in the repository. Release
-assembly copies the declared members, rewrites internal imports to SDK subpaths,
-and exposes their original entrypoints. Only the assembled SDK is published.
+Licensed under MIT. Repository documentation and source require repository access while the repositories are private.

package/modules/agents/package.json

@@ -31,7 +31,7 @@
 		"@tsrx/typescript-plugin": "0.3.120",
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/modules/auth/package.json

@@ -36,7 +36,7 @@
 		"@types/node": "24.13.3",
 		"@types/pg": "8.23.1",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/modules/auth/src/client/AuthenticationCore.tsrx

@@ -348,7 +348,9 @@ function AuthenticationForm(props: AuthenticationFormProps) @{
 									/>
 								</FormField>
 								<p class="auth-slug-preview">
-									{t('auth.signup.workspace.address') + ' ' + applicationPath() + '/'}
+									{t('auth.signup.workspace.address') + ' ' +
+										applicationPath() +
+										'/'}
 									<b>
 										{workspaceSlug || t('auth.signup.workspace.placeholder')}
 									</b>

package/modules/auth/src/server/endpoints.ts

@@ -369,7 +369,9 @@ export function createAuthRoutes(runtime: AuthRuntime): readonly ServerRoute[] {
 					headers.append('set-cookie', expiredState);
 					return new Response(null, { status: 302, headers });
 				}
-				const headers = new Headers({ location: '/app' });
+				const headers = new Headers({
+					location: runtime.applicationPath ?? '/app',
+				});
 				headers.append(
 					'set-cookie',
 					sessionCookie(issued.token, runtime.cookie),

package/modules/auth/src/server/runtime.ts

@@ -1,3 +1,4 @@
+import { validateApplicationPath } from '@flowdular/sdk/server';
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import type { Middleware } from '@octanejs/app-core';
@@ -76,6 +77,7 @@ export interface AuthRuntimeEnvironmentOptions {
 	readonly mailDelivery?: AuthMailDelivery;
 	readonly mfaEncryptionKey?: string;
 	readonly publicBaseUrl?: string;
+	readonly applicationPath?: string;
 	readonly oidcProviders?: readonly OidcProvider[];
 	readonly production?: boolean;
 	readonly contentSecurityPolicy?: string | null;
@@ -104,6 +106,7 @@ export interface AuthRuntime {
 	readonly workspaceRoot: string | null;
 	readonly oidcProviders: readonly OidcProvider[];
 	readonly publicBaseUrl: string | null;
+	readonly applicationPath?: string;
 	/* Resolves once the schema is migrated and the leases are held. Concurrent
 	   first callers await the same initialization. */
 	service(): Promise<AuthService>;
@@ -667,6 +670,7 @@ export function createAuthRuntime(options: AuthRuntimeOptions): AuthRuntime {
 		workspaceRoot: options.workspaceRoot ?? null,
 		oidcProviders: options.oidcProviders ?? [],
 		publicBaseUrl: options.publicBaseUrl ?? null,
+		applicationPath: validateApplicationPath(options.applicationPath ?? '/app'),
 		service,
 		async authorizeAgentToolAccess(tenantId, actor) {
 			const identity = normalizeActor(actor);

package/modules/automations/package.json

@@ -30,7 +30,7 @@
 		"@tsrx/typescript-plugin": "0.3.120",
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/modules/automations-workflows-integration/package.json

@@ -23,7 +23,7 @@
 	"devDependencies": {
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/modules/profile/package.json

@@ -30,7 +30,7 @@
 		"@tsrx/typescript-plugin": "0.3.120",
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/modules/sandbox/package.json

@@ -31,7 +31,7 @@
 		"@tsrx/typescript-plugin": "0.3.120",
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/modules/system/package.json

@@ -31,7 +31,7 @@
 		"@tsrx/typescript-plugin": "0.3.120",
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/modules/users/package.json

@@ -29,7 +29,7 @@
 		"@tsrx/typescript-plugin": "0.3.120",
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/modules/workflows/package.json

@@ -30,7 +30,7 @@
 		"@tsrx/typescript-plugin": "0.3.120",
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@flowdular/sdk",
-	"version": "0.1.0",
+	"version": "0.2.1",
 	"type": "module",
 	"description": "Flowdular platform SDK: server, client, UI, data, agents and core modules through separate exports.",
 	"license": "MIT",
@@ -22,7 +22,6 @@
 		"./ui/styles": "./packages/ui/src/styles/index.css",
 		"./database": "./packages/database/src/index.ts",
 		"./database/postgresql": "./packages/database/src/postgresql.ts",
-		"./coding-agent": "./packages/coding-agent/src/index.ts",
 		"./database-testing": "./packages/database-testing/src/index.ts",
 		"./database-testing/vitest": "./packages/database-testing/src/vitest-preset.ts",
 		"./ai-provider": "./packages/ai-provider/src/index.ts",
@@ -38,8 +37,6 @@
 		"./harness/tool-adapters": "./packages/harness/src/tool-adapters.ts",
 		"./harness/catalog": "./packages/harness/src/catalog.ts",
 		"./harness/schema": "./packages/harness/schemas/task-packet.schema.json",
-		"./sandbox": "./packages/sandbox/src/index.ts",
-		"./sandbox/server": "./packages/sandbox/src/server/index.ts",
 		"./database-pglite": "./packages/database-pglite/src/index.ts",
 		"./dev-console": "./packages/dev-console/src/index.mjs",
 		"./client": "./packages/client/src/index.ts",
@@ -101,8 +98,6 @@
 		"@octanejs/tanstack-table": "0.1.51",
 		"chart.js": "^4.5.1",
 		"octane": "0.1.51",
-		"ai": "7.0.85",
-		"yaml": "2.9.0",
 		"pg": "8.23.0",
 		"@types/pg": "8.23.1",
 		"@ai-sdk/anthropic": "4.0.46",
@@ -110,16 +105,13 @@
 		"@ai-sdk/gateway": "4.0.69",
 		"@ai-sdk/openai": "4.0.52",
 		"@ai-sdk/openai-compatible": "3.0.41",
+		"ai": "7.0.85",
 		"@octanejs/app-core": "0.0.47",
+		"@electric-sql/pglite": "0.5.8",
 		"@octanejs/seo": "0.0.38",
-		"@octanejs/vite-plugin": "0.1.51",
 		"segment-state": "0.2.0",
-		"vite": "8.2.2",
-		"@electric-sql/pglite": "0.5.8",
 		"semver": "7.7.4",
-		"@types/semver": "7.7.1"
-	},
-	"bin": {
-		"flowdular-sandbox": "./packages/sandbox/bin/flowdular-sandbox.mjs"
+		"@types/semver": "7.7.1",
+		"yaml": "2.9.0"
 	}
 }

package/packages/ai-provider/package.json

@@ -21,7 +21,7 @@
 	},
 	"devDependencies": {
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/packages/cli-protocol/package.json

@@ -15,7 +15,7 @@
 	"devDependencies": {
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/packages/client/package.json

@@ -21,7 +21,7 @@
 	"devDependencies": {
 		"@tsrx/typescript-plugin": "0.3.120",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/packages/client/src/routing.ts

@@ -2,8 +2,45 @@ let basePath = '/app';
 
 /** Installation-wide value emitted by the CLI, never a request/tenant setting. */
 export function configureApplicationRouting(path: string): void {
-	if (!/^\/[a-z][a-z0-9-]*$/.test(path) || ['auth', 'api', 'sites', 'sign-in', 'sign-up', 'forgot-password', 'reset-password', 'accept-invitation'].includes(path.slice(1))) throw new Error('Invalid application path.');
+	if (
+		path.length > 64 ||
+		!/^\/[a-z][a-z0-9-]*$/.test(path) ||
+		[
+			'setup',
+			'health',
+			'ready',
+			'assets',
+			'auth',
+			'api',
+			'sites',
+			'sign-in',
+			'sign-up',
+			'forgot-password',
+			'reset-password',
+			'accept-invitation',
+		].includes(path.slice(1))
+	)
+		throw new Error('Invalid application path.');
 	basePath = path;
 }
 
-export function applicationPath(): string { return basePath; }
+export function applicationPath(): string {
+	return basePath;
+}
+
+/** Select the server's installation setting during SSR and browser hydration. */
+export function configureApplicationFromPage(
+	props: { readonly state?: Map<string, unknown> } | undefined,
+	fallback = '/app',
+): void {
+	let path = props?.state?.get('flowdular.application.path');
+	if (path === undefined && typeof document !== 'undefined') {
+		const data = document.getElementById(
+			'flowdular-application-data',
+		)?.textContent;
+		if (data) path = JSON.parse(data);
+	}
+	if (path !== undefined && typeof path !== 'string')
+		throw new Error('Invalid application path.');
+	configureApplicationRouting(path ?? fallback);
+}

package/packages/client/src/shell/BrandMark.tsrx

@@ -3,7 +3,11 @@ import { BrandMark } from '@flowdular/sdk/ui';
 import { t } from '../i18n/runtime.ts';
 
 export function SidebarBrand() @{
-	<a class="sidebar__home" href={applicationPath()} aria-label={t('shell.brand.home')}>
+	<a
+		class="sidebar__home"
+		href={applicationPath()}
+		aria-label={t('shell.brand.home')}
+	>
 		<BrandMark size={22} />
 		<span class="sidebar__wordmark">Flowdular</span>
 	</a>

package/packages/client/src/shell/navigation.ts

@@ -62,7 +62,9 @@ export function viewHref(
 	viewId: ShellView,
 	workspaceSlug?: string | null,
 ): string {
-	const base = workspaceSlug ? applicationPath() + '/' + workspaceSlug : applicationPath();
+	const base = workspaceSlug
+		? applicationPath() + '/' + workspaceSlug
+		: applicationPath();
 	if (viewId === 'overview') return base;
 	return base + '/' + viewId;
 }

package/packages/client/src/state.ts

@@ -20,7 +20,11 @@ export function toggleNavigationGroup(
 export function shellViewFromUrl(value: string): ShellView {
 	const pathname = new URL(value, 'https://flowdular.local').pathname;
 	const segments = pathname.split('/').filter(Boolean);
-	return ((segments[0] === applicationPath().slice(1) || segments[0] === 'app') ? segments[2] : segments[0]) ?? 'overview';
+	return (
+		(segments[0] === applicationPath().slice(1) || segments[0] === 'app'
+			? segments[2]
+			: segments[0]) ?? 'overview'
+	);
 }
 
 /* Canonical workspace URLs live below /app. Slug-first and view-only links are
@@ -31,7 +35,7 @@ export function shellLocationFromUrl(
 ): ShellLocation {
 	const pathname = new URL(value, 'https://flowdular.local').pathname;
 	const segments = pathname.split('/').filter(Boolean);
-	if ((segments[0] === applicationPath().slice(1) || segments[0] === 'app')) {
+	if (segments[0] === applicationPath().slice(1) || segments[0] === 'app') {
 		const workspace = segments[1];
 		if (workspace !== undefined && knownWorkspaceSlugs.includes(workspace)) {
 			return { workspaceSlug: workspace, view: segments[2] ?? 'overview' };

package/packages/contracts/package.json

@@ -13,7 +13,7 @@
 	},
 	"devDependencies": {
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/packages/contracts/schemas/project.schema.json

@@ -25,10 +25,7 @@
 		"specs": {
 			"type": "object",
 			"additionalProperties": false,
-			"required": [
-				"platformRoot",
-				"moduleDirectory"
-			],
+			"required": ["platformRoot", "moduleDirectory"],
 			"properties": {
 				"platformRoot": {
 					"type": "string",
@@ -43,10 +40,7 @@
 		"modules": {
 			"type": "object",
 			"additionalProperties": false,
-			"required": [
-				"roots",
-				"enabled"
-			],
+			"required": ["roots", "enabled"],
 			"properties": {
 				"roots": {
 					"type": "array",
@@ -79,11 +73,7 @@
 		"agent": {
 			"type": "object",
 			"additionalProperties": false,
-			"required": [
-				"policy",
-				"blueprints",
-				"modelRouting"
-			],
+			"required": ["policy", "blueprints", "modelRouting"],
 			"properties": {
 				"policy": {
 					"type": "string",
@@ -135,17 +125,10 @@
 									"$ref": "#/$defs/gitName"
 								},
 								"provider": {
-									"enum": [
-										"github",
-										"none"
-									]
+									"enum": ["github", "none"]
 								},
 								"mode": {
-									"enum": [
-										"auto",
-										"direct",
-										"fork"
-									]
+									"enum": ["auto", "direct", "fork"]
 								},
 								"forkOwner": {
 									"$ref": "#/$defs/githubAccount"
@@ -171,9 +154,7 @@
 		"web": {
 			"type": "object",
 			"additionalProperties": false,
-			"required": [
-				"mounts"
-			],
+			"required": ["mounts"],
 			"properties": {
 				"mounts": {
 					"type": "array",
@@ -181,13 +162,7 @@
 					"items": {
 						"type": "object",
 						"additionalProperties": false,
-						"required": [
-							"id",
-							"moduleId",
-							"surfaceId",
-							"path",
-							"tenantId"
-						],
+						"required": ["id", "moduleId", "surfaceId", "path", "tenantId"],
 						"properties": {
 							"id": {
 								"type": "string",
@@ -222,9 +197,7 @@
 		"application": {
 			"type": "object",
 			"additionalProperties": false,
-			"required": [
-				"path"
-			],
+			"required": ["path"],
 			"properties": {
 				"path": {
 					"type": "string",
@@ -238,20 +211,21 @@
 							"/sign-up",
 							"/forgot-password",
 							"/reset-password",
-							"/accept-invitation"
+							"/accept-invitation",
+							"/setup",
+							"/health",
+							"/ready",
+							"/assets"
 						]
-					}
+					},
+					"maxLength": 64
 				}
 			}
 		}
 	},
 	"$defs": {
 		"deliveryTarget": {
-			"enum": [
-				"workspace",
-				"git-pr",
-				"official-modules"
-			]
+			"enum": ["workspace", "git-pr", "official-modules"]
 		},
 		"gitName": {
 			"type": "string",

package/packages/database/package.json

@@ -18,7 +18,7 @@
 		"@flowdular/database-testing": "workspace:*",
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/packages/database-pglite/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@flowdular/database-pglite",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"type": "module",
 	"exports": {
 		".": "./src/index.ts"
@@ -17,7 +17,7 @@
 		"@flowdular/database-testing": "workspace:*",
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {

package/packages/database-pglite/src/driver.ts

@@ -81,22 +81,40 @@ export function createPgliteCluster(
 	const close = (): Promise<void> => {
 		closePromise ??= (async () => {
 			if (!databasePromise) return;
-			const instance = await databasePromise;
+			// A failed initialization has no database to close; its caller already
+			// received the original error. Do not replace it during disposal.
+			const instance = await databasePromise.catch(() => undefined);
 			databasePromise = undefined;
-			await instance.close();
+			await instance?.close();
 		})();
 		return closePromise;
 	};
 
 	const database = async (): Promise<PGlite> => {
 		databasePromise ??= (async () => {
+			if (options.dataDirectory) {
+				const { mkdir } = await import('node:fs/promises');
+				await mkdir(options.dataDirectory, { recursive: true, mode: 0o700 });
+			}
 			const created = options.dataDirectory
 				? await PGlite.create({
 						dataDir: options.dataDirectory,
 						parsers: SERVER_PARSERS,
 					})
 				: await PGlite.create({ parsers: SERVER_PARSERS });
-			if (options.bootstrap) await created.exec(options.bootstrap);
+			try {
+				if (options.bootstrap) await created.exec(options.bootstrap);
+			} catch (error) {
+				try {
+					await created.close();
+				} catch (closeError) {
+					throw new AggregateError(
+						[error, closeError],
+						'PGlite bootstrap failed and cleanup also failed.',
+					);
+				}
+				throw error;
+			}
 			return created;
 		})();
 		return databasePromise;

package/packages/database-testing/package.json

@@ -19,7 +19,7 @@
 	"devDependencies": {
 		"@types/node": "24.13.3",
 		"typescript": "5.9.3",
-		"vitest": "4.1.10"
+		"vitest": "4.1.11"
 	},
 	"license": "MIT",
 	"repository": {