@fabrika/app 0.8.1 → 0.9.0-dev.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fabrika/app",
-	"version": "0.8.1",
+	"version": "0.9.0-dev.2",
 	"type": "module",
 	"license": "MIT",
 	"repository": {
@@ -14,77 +14,88 @@
 	"files": [
 		"src",
 		"skill",
-		"!src/**/__tests__/**"
+		"!src/**/__tests__/**",
+		"types"
 	],
 	"exports": {
 		".": {
 			"bun": "./src/index.ts",
-			"types": "./src/index.ts",
+			"types": "./types/src/index.d.ts",
 			"default": "./src/index.ts"
 		},
 		"./bun": {
 			"bun": "./src/bun.ts",
-			"types": "./src/bun.ts",
+			"types": "./types/src/bun.d.ts",
 			"default": "./src/bun.ts"
 		},
 		"./cloudflare": {
 			"bun": "./src/cloudflare.ts",
-			"types": "./src/cloudflare.ts",
+			"types": "./types/src/cloudflare.d.ts",
 			"default": "./src/cloudflare.ts"
 		},
 		"./contract": {
 			"bun": "./src/contract/index.ts",
-			"types": "./src/contract/index.ts",
+			"types": "./types/src/contract/index.d.ts",
 			"default": "./src/contract/index.ts"
 		},
 		"./client": {
 			"bun": "./src/client/index.ts",
-			"types": "./src/client/index.ts",
+			"types": "./types/src/client/index.d.ts",
 			"default": "./src/client/index.ts"
 		},
 		"./react": {
 			"bun": "./src/react/index.ts",
-			"types": "./src/react/index.ts",
+			"types": "./types/src/react/index.d.ts",
 			"default": "./src/react/index.ts"
 		},
 		"./react/testing": {
 			"bun": "./src/react/testing.ts",
-			"types": "./src/react/testing.ts",
+			"types": "./types/src/react/testing.d.ts",
 			"default": "./src/react/testing.ts"
 		},
 		"./implement": {
 			"bun": "./src/implement/index.ts",
-			"types": "./src/implement/index.ts",
+			"types": "./types/src/implement/index.d.ts",
 			"default": "./src/implement/index.ts"
 		},
 		"./service": {
 			"bun": "./src/service/index.ts",
-			"types": "./src/service/index.ts",
+			"types": "./types/src/service/index.d.ts",
 			"default": "./src/service/index.ts"
 		},
 		"./build": {
 			"bun": "./src/build.ts",
-			"types": "./src/build.ts",
+			"types": "./types/src/build.d.ts",
 			"default": "./src/build.ts"
 		},
 		"./testing": {
 			"bun": "./src/testing/index.ts",
-			"types": "./src/testing/index.ts",
+			"types": "./types/src/testing/index.d.ts",
 			"default": "./src/testing/index.ts"
 		},
 		"./testing/isolation": {
 			"bun": "./src/testing/isolation.ts",
-			"types": "./src/testing/isolation.ts",
+			"types": "./types/src/testing/isolation.d.ts",
 			"default": "./src/testing/isolation.ts"
 		},
 		"./testing/preload": {
 			"bun": "./src/testing/preload.ts",
-			"types": "./src/testing/preload.ts",
+			"types": "./types/src/testing/preload.d.ts",
 			"default": "./src/testing/preload.ts"
 		},
+		"./dev": {
+			"bun": "./src/dev/index.ts",
+			"types": "./types/src/dev/index.d.ts",
+			"default": "./src/dev/index.ts"
+		},
+		"./dev/wire": {
+			"bun": "./src/dev/wire.ts",
+			"types": "./types/src/dev/wire.d.ts",
+			"default": "./src/dev/wire.ts"
+		},
 		"./agent-skill": {
 			"bun": "./src/agent-skill.ts",
-			"types": "./src/agent-skill.ts",
+			"types": "./types/src/agent-skill.d.ts",
 			"default": "./src/agent-skill.ts"
 		}
 	},
@@ -93,14 +104,14 @@
 		"test": "bun test --path-ignore-patterns='src/react/**' && bun test --isolate src/react"
 	},
 	"dependencies": {
-		"@fabrika/auth": "0.8.1",
-		"@fabrika/auth-core": "0.8.1",
-		"@fabrika/db": "0.8.1",
-		"@fabrika/email": "0.8.1",
-		"@fabrika/jwks": "0.8.1",
-		"@fabrika/platform": "0.8.1",
-		"@fabrika/platform-node": "0.8.1",
-		"@fabrika/proxy-core": "0.8.1",
+		"@fabrika/auth": "0.9.0-dev.2",
+		"@fabrika/auth-core": "0.9.0-dev.2",
+		"@fabrika/db": "0.9.0-dev.2",
+		"@fabrika/email": "0.9.0-dev.2",
+		"@fabrika/jwks": "0.9.0-dev.2",
+		"@fabrika/platform": "0.9.0-dev.2",
+		"@fabrika/platform-node": "0.9.0-dev.2",
+		"@fabrika/proxy-core": "0.9.0-dev.2",
 		"altcha-lib": "2.6.0",
 		"jose": "^5.9.0"
 	},

package/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fabrika-app
-version: 0.8.1
+version: 0.9.0-dev.2
 description: >
   How to write and change a Fabrika application: src/vocabulary.ts, db/migrations/, src/db/tables.ts, the
   slices' endpoints.ts with their handlers, fabrika.contract.ts, jobs, files, webhooks, share links, connectors

package/skill/references/app-setup.md

@@ -19,20 +19,20 @@ the SPA is added with it.
 		"test": "bun test --isolate"
 	},
 	"dependencies": {
-		"@fabrika/app": "0.8.1",
-		"@fabrika/db": "0.8.1",
-		"@fabrika/provider-zerops": "0.8.1",
-		"@fabrika/proxy-core": "0.8.1",
-		"@fabrika/ui": "0.8.1",
+		"@fabrika/app": "0.9.0-dev.2",
+		"@fabrika/db": "0.9.0-dev.2",
+		"@fabrika/provider-zerops": "0.9.0-dev.2",
+		"@fabrika/proxy-core": "0.9.0-dev.2",
+		"@fabrika/ui": "0.9.0-dev.2",
 		"kysely": "0.29.6",
 		"react": "^19.0.0",
 		"react-dom": "^19.0.0",
 		"zod": "^3.25.76"
 	},
 	"devDependencies": {
-		"@fabrika/check": "0.8.1",
-		"@fabrika/cli": "0.8.1",
-		"@fabrika/platform": "0.8.1",
+		"@fabrika/check": "0.9.0-dev.2",
+		"@fabrika/cli": "0.9.0-dev.2",
+		"@fabrika/platform": "0.9.0-dev.2",
 		"@happy-dom/global-registrator": "^20.11.2",
 		"@types/bun": "latest",
 		"@types/react": "^19.0.0",

package/src/dev/changes.ts

@@ -0,0 +1,35 @@
+// What a sync changes, read off its paths: whether the build owns one (then the commit needs a bootstrap run), whether
+// the migrations changed, and whether a web source did. Whether the contract changed is the digest's to say, not a path's.
+
+import { CONTRACT_FILE } from '../build.js'
+
+/** The application's migrations, as `fabrika db migrate` reads them. */
+export const MIGRATIONS_DIRECTORY = 'db/migrations/'
+
+/** Files whose change the build turns into something else: an install, or the generated run and build descriptors. */
+const BUILD_OWNED_FILES: ReadonlySet<string> = new Set(['package.json', 'bun.lock', 'bun.lockb', 'bunfig.toml', 'zerops.yaml', 'zerops.yml'])
+const BUILD_OWNED_DIRECTORIES = ['fabrika/', 'node_modules/'] as const
+
+/** Server code and the database: a change only there leaves the SPA as it is. */
+const SERVER_DIRECTORIES = ['src/', 'db/'] as const
+
+/** Why the change needs a bootstrap run, in one line, or null when the launcher may apply it. */
+export function bootstrapReason(paths: readonly string[]): string | null {
+	for (const path of paths) {
+		const why = BUILD_OWNED_FILES.has(path)
+			? 'the dependencies, the lockfile or the build descriptor'
+			: BUILD_OWNED_DIRECTORIES.some((directory) => path.startsWith(directory))
+			? 'the generated files or the installed packages'
+			: path !== CONTRACT_FILE && path.startsWith('fabrika.') && !path.includes('/')
+			? 'a fabrika.* file'
+			: null
+		if (why !== null) return `${path} changed, which is ${why}; that needs a bootstrap run: call bind_dev again`
+	}
+	return null
+}
+
+export const migrationsChanged = (paths: readonly string[]): boolean => paths.some((path) => path.startsWith(MIGRATIONS_DIRECTORY))
+
+/** A change outside the server code and the database may reach the SPA, so its build runs again. */
+export const webSourceChanged = (paths: readonly string[]): boolean =>
+	paths.some((path) => !SERVER_DIRECTORIES.some((directory) => path.startsWith(directory)))

package/src/dev/contract-digest.ts

@@ -0,0 +1,17 @@
+// The launcher's child that answers whether a commit changed the contract (ADR-0049). It runs in the application root
+// with no credential in its environment, loads the application module the launcher itself never loads, and prints the
+// digest the application's boot compares with `FABRIKA_CONTRACT_DIGEST`.
+
+import { contractDigest } from '@fabrika/auth-core'
+import { join } from 'node:path'
+import { IMPLEMENTATION_FILE } from '../build.js'
+import { compileContract } from '../contract/compile.js'
+import { isContractImplementation } from '../implement/implement.js'
+
+const module: unknown = await import(join(process.cwd(), IMPLEMENTATION_FILE))
+const app = typeof module === 'object' && module !== null ? Reflect.get(module, 'default') : undefined
+if (!isContractImplementation(app)) {
+	console.error(`${IMPLEMENTATION_FILE} does not default-export serve(contract, { … })`)
+	process.exit(1)
+}
+console.log(contractDigest(compileContract(app.contract, app.database?.tables ?? {})))

package/src/dev/index.ts

@@ -0,0 +1,11 @@
+// @fabrika/app/dev — the launcher of a `dev` environment, which the generated dev entrypoint runs (Bun only).
+
+export { bootstrapReason, migrationsChanged, webSourceChanged } from './changes.js'
+export {
+	type DevLauncher,
+	type DevLauncherOptions,
+	type DevSourceTransport,
+	readDevLauncherConfig,
+	runDevLauncher,
+	startDevLauncher,
+} from './launcher.js'