C6: Runtime kernel owns data, status, error — adapters subscribe

The kernel is no longer a blind refetch pipe. Each context entry has:
  { data, status: idle|loading|success|error, error }

registerContext() returns { getState, subscribe, refetch, unregister }.
Adapters subscribe to state changes via callbacks. The kernel does
the fetch and notifies subscribers with the new state.

React adapter uses useSyncExternalStore for tear-free reads.
Vue adapter uses ref + subscribe callback.
Svelte adapter uses readable store backed by kernel subscription.

All three adapters also get:
- Mutation hooks with { mutate, isPending, error } (fixes H5)
- Vue: onServerPrefetch for Nuxt SSR (fixes M9)
- Svelte: readable store auto-cleans up on unsubscribe (fixes H9)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-07 12:38:53 -04:00
parent 07f1c7842c
commit bb88fd984b
7 changed files with 586 additions and 361 deletions

View File

@@ -2,117 +2,142 @@
// AUTO-GENERATED by mizan — do not edit
import { createContext, useContext, useState, useEffect, useCallback, type ReactNode } from 'react'
import { registerContext, mizanCall, mizanFetch } from '@mizan/runtime'
import { createContext, useContext, useState, useEffect, useCallback, useRef, useSyncExternalStore, type ReactNode } from 'react'
import { registerContext, mizanFetch, mizanCall, type ContextState } from '@mizan/runtime'
import { fetchGlobalContext, type GlobalContextData, type GlobalContextParams, fetchLocalContext, type LocalContextData, type LocalContextParams, callEcho, callAdd, callWhoami, callHttpOnlyEcho, callStaffOnly, callSuperuserOnly, callVerifiedOnly, callMultiply, callNotImplementedFn, callBuggyFn, callPermissionCheckFn, callWsWhoami, callJwtObtain, callJwtRefresh } from '../index'
// Global context — fetched once at app init
const GlobalCtx = createContext<GlobalContextData | null>(null)
// Subscribe to kernel state via useSyncExternalStore
function useContextState<T>(
name: string,
params: Record<string, any>,
fetchFn: () => Promise<T>,
initialData?: T,
): ContextState<T> {
const ref = useRef<ReturnType<typeof registerContext> | null>(null)
export function GlobalContextProvider({ children }: { children: ReactNode }) {
const [data, setData] = useState<GlobalContextData | null>(() => {
if (typeof window === 'undefined') return null
const ssr = (window as any).__MIZAN_SSR_DATA__
return ssr ?? null
})
if (!ref.current) {
ref.current = registerContext(name, params, fetchFn, initialData)
}
const refetch = useCallback(async () => {
const result = await fetchGlobalContext({} as any)
setData(result)
}, [])
const handle = ref.current
useEffect(() => { if (!data) refetch() }, [data, refetch])
useEffect(() => registerContext('global', {}, refetch), [refetch])
// Fetch on mount if no data
useEffect(() => {
if (handle.getState().status === 'idle') handle.refetch()
return () => handle.unregister()
}, [handle])
return <GlobalCtx.Provider value={data}>{children}</GlobalCtx.Provider>
return useSyncExternalStore(
handle.subscribe,
handle.getState,
handle.getState,
)
}
export function useCurrentUser(): currentUserOutput {
const ctx = useContext(GlobalCtx)
if (!ctx) throw new Error('useCurrentUser requires GlobalContextProvider')
return ctx.current_user
// Mutation hook with loading/error state
function useMutation<TArgs, TResult>(
callFn: (args: TArgs) => Promise<TResult>,
): { mutate: (args: TArgs) => Promise<TResult>; isPending: boolean; error: Error | null } {
const [isPending, setIsPending] = useState(false)
const [error, setError] = useState<Error | null>(null)
const mutate = useCallback(async (args: TArgs) => {
setIsPending(true)
setError(null)
try {
const result = await callFn(args)
return result
} catch (e) {
setError(e as Error)
throw e
} finally {
setIsPending(false)
}
}, [callFn])
return { mutate, isPending, error }
}
// Local context
const LocalCtx = createContext<LocalContextData | null>(null)
// ── Global Context ──
export function LocalContext({ children, ...params }: LocalContextParams & { children: ReactNode }) {
const [data, setData] = useState<LocalContextData | null>(() => {
if (typeof window === 'undefined') return null
const ssr = (window as any).__MIZAN_SSR_DATA__
if (ssr?.greet !== undefined) return ssr
return null
})
const refetch = useCallback(async () => {
const result = await fetchLocalContext(params)
setData(result)
}, [params.name])
useEffect(() => { refetch() }, [refetch])
useEffect(() => registerContext('local', params, refetch), [params.name, refetch])
return <LocalCtx.Provider value={data}>{children}</LocalCtx.Provider>
export function useGlobalContext(): ContextState<GlobalContextData> {
const ssrData = typeof window !== 'undefined' ? (window as any).__MIZAN_SSR_DATA__ : null
return useContextState('global', {}, () => fetchGlobalContext({} as any), ssrData)
}
export function useGreet(): greetOutput | null {
const ctx = useContext(LocalCtx)
return ctx?.greet ?? null
export function useCurrentUser(): currentUserOutput | null {
const state = useGlobalContext()
return state.data?.current_user ?? null
}
// ── Local Context ──
export function useLocalContext(params: LocalContextParams): ContextState<LocalContextData> {
const ssrData = typeof window !== 'undefined' ? (window as any).__MIZAN_SSR_DATA__ : null
return useContextState('local', params, () => fetchLocalContext(params), ssrData)
}
export function useGreet(params: LocalContextParams): greetOutput | null {
const state = useLocalContext(params)
return state.data?.greet ?? null
}
export function useEcho() {
return useCallback((args: Parameters<typeof callEcho>[0]) => callEcho(args), [])
return useMutation<Parameters<typeof callEcho>[0], Awaited<ReturnType<typeof callEcho>>>(callEcho)
}
export function useAdd() {
return useCallback((args: Parameters<typeof callAdd>[0]) => callAdd(args), [])
return useMutation<Parameters<typeof callAdd>[0], Awaited<ReturnType<typeof callAdd>>>(callAdd)
}
export function useWhoami() {
return useCallback(() => callWhoami(), [])
return useMutation<void, Awaited<ReturnType<typeof callWhoami>>>(() => callWhoami() as any)
}
export function useHttpOnlyEcho() {
return useCallback((args: Parameters<typeof callHttpOnlyEcho>[0]) => callHttpOnlyEcho(args), [])
return useMutation<Parameters<typeof callHttpOnlyEcho>[0], Awaited<ReturnType<typeof callHttpOnlyEcho>>>(callHttpOnlyEcho)
}
export function useStaffOnly() {
return useCallback(() => callStaffOnly(), [])
return useMutation<void, Awaited<ReturnType<typeof callStaffOnly>>>(() => callStaffOnly() as any)
}
export function useSuperuserOnly() {
return useCallback(() => callSuperuserOnly(), [])
return useMutation<void, Awaited<ReturnType<typeof callSuperuserOnly>>>(() => callSuperuserOnly() as any)
}
export function useVerifiedOnly() {
return useCallback(() => callVerifiedOnly(), [])
return useMutation<void, Awaited<ReturnType<typeof callVerifiedOnly>>>(() => callVerifiedOnly() as any)
}
export function useMultiply() {
return useCallback((args: Parameters<typeof callMultiply>[0]) => callMultiply(args), [])
return useMutation<Parameters<typeof callMultiply>[0], Awaited<ReturnType<typeof callMultiply>>>(callMultiply)
}
export function useNotImplementedFn() {
return useCallback(() => callNotImplementedFn(), [])
return useMutation<void, Awaited<ReturnType<typeof callNotImplementedFn>>>(() => callNotImplementedFn() as any)
}
export function useBuggyFn() {
return useCallback(() => callBuggyFn(), [])
return useMutation<void, Awaited<ReturnType<typeof callBuggyFn>>>(() => callBuggyFn() as any)
}
export function usePermissionCheckFn() {
return useCallback((args: Parameters<typeof callPermissionCheckFn>[0]) => callPermissionCheckFn(args), [])
return useMutation<Parameters<typeof callPermissionCheckFn>[0], Awaited<ReturnType<typeof callPermissionCheckFn>>>(callPermissionCheckFn)
}
export function useWsWhoami() {
return useCallback(() => callWsWhoami(), [])
return useMutation<void, Awaited<ReturnType<typeof callWsWhoami>>>(() => callWsWhoami() as any)
}
export function useJwtObtain() {
return useCallback(() => callJwtObtain(), [])
return useMutation<void, Awaited<ReturnType<typeof callJwtObtain>>>(() => callJwtObtain() as any)
}
export function useJwtRefresh() {
return useCallback((args: Parameters<typeof callJwtRefresh>[0]) => callJwtRefresh(args), [])
return useMutation<Parameters<typeof callJwtRefresh>[0], Awaited<ReturnType<typeof callJwtRefresh>>>(callJwtRefresh)
}
export type { ContextState } from '@mizan/runtime'
export { configure, initSession, MizanError } from '@mizan/runtime'