mizan/protocol/mizan-codegen/templates/react/react.tsx.j2

'use client'

// AUTO-GENERATED by mizan — do not edit

{% set has_contexts = has_global || !named_contexts.is_empty() -%}
import {
    {% if has_contexts -%}
    createContext,
    {% endif -%}
    useCallback,
    {% if has_contexts -%}
    useContext,
    useEffect,
    {% endif -%}
    useRef,
    useState,
    {% if has_contexts -%}
    useSyncExternalStore,
    {% endif -%}
    type ReactNode,
} from 'react'
import {
    configure,
    mizanCall,
    mizanFetch,
    {% if has_contexts -%}
    registerContext,
    type ContextState,
    {% endif -%}
} from '@mizan/base'

{% if !stage1_imports.is_empty() -%}
import { {{ stage1_imports|join(", ") }} } from './index'

{% endif -%}
{% if has_contexts -%}
// Internal — runs inside a Provider, registers with the kernel exactly once.
function useContextSubscription<T>(
    name: string,
    params: Record<string, any>,
    fetchFn: () => Promise<T>,
    initialData?: T,
): ContextState<T> {
    const ref = useRef<ReturnType<typeof registerContext> | null>(null)
    if (!ref.current) {
        ref.current = registerContext(name, params, fetchFn, initialData)
    }
    const handle = ref.current

    useEffect(() => {
        if (handle.getState().status === 'idle') handle.refetch()
        return () => handle.unregister()
    }, [handle])

    return useSyncExternalStore(handle.subscribe, handle.getState, handle.getState)
}
{% endif %}

// Internal — wraps an imperative call() with isPending / error state.
interface MutationHook<TArgs, TResult> {
    mutate: (args: TArgs) => Promise<TResult>
    isPending: boolean
    error: Error | null
}

function useMutation<TArgs, TResult>(
    callFn: (args: TArgs) => Promise<TResult>,
): MutationHook<TArgs, TResult> {
    const [isPending, setIsPending] = useState(false)
    const [error, setError] = useState<Error | null>(null)

    const mutate = useCallback(async (args: TArgs) => {
        setIsPending(true)
        setError(null)
        try {
            return await callFn(args)
        } catch (e) {
            setError(e as Error)
            throw e
        } finally {
            setIsPending(false)
        }
    }, [callFn])

    return { mutate, isPending, error }
}
{% if has_global %}
// ── Global Context ──

const GlobalCtx = createContext<ContextState<GlobalContextData> | null>(null)

export function GlobalContextProvider({ children }: { children: ReactNode }) {
    const ssrData = typeof window !== 'undefined' ? (window as any).__MIZAN_SSR_DATA__ : undefined
    const state = useContextSubscription('global', {}, () => fetchGlobalContext({} as any), ssrData)
    return <GlobalCtx.Provider value={state}>{children}</GlobalCtx.Provider>
}

export function useGlobalContext(): ContextState<GlobalContextData> {
    const ctx = useContext(GlobalCtx)
    if (!ctx) throw new Error('useGlobalContext requires <MizanContext> or <GlobalContextProvider>')
    return ctx
}
{% for fn in global_fns %}
export function use{{ fn.pascal }}(): {{ fn.output_type }} | null {
    return useGlobalContext().data?.{{ fn.name }} ?? null
}
{% endfor -%}
{% endif -%}
{% for ctx in named_contexts %}
// ── {{ ctx.pascal }} Context ──

const {{ ctx.pascal }}Ctx = createContext<ContextState<{{ ctx.pascal }}ContextData> | null>(null)

{% if ctx.has_params -%}
export function {{ ctx.pascal }}Context({ children, ...params }: {{ ctx.pascal }}ContextParams & { children: ReactNode }) {
    const state = useContextSubscription('{{ ctx.name }}', params, () => fetch{{ ctx.pascal }}Context(params))
    return <{{ ctx.pascal }}Ctx.Provider value={state}>{children}</{{ ctx.pascal }}Ctx.Provider>
}
{% else -%}
export function {{ ctx.pascal }}Context({ children }: { children: ReactNode }) {
    const state = useContextSubscription('{{ ctx.name }}', {}, () => fetch{{ ctx.pascal }}Context({} as any))
    return <{{ ctx.pascal }}Ctx.Provider value={state}>{children}</{{ ctx.pascal }}Ctx.Provider>
}
{% endif %}
export function use{{ ctx.pascal }}Context(): ContextState<{{ ctx.pascal }}ContextData> {
    const ctx = useContext({{ ctx.pascal }}Ctx)
    if (!ctx) throw new Error('use{{ ctx.pascal }}Context requires <{{ ctx.pascal }}Context>')
    return ctx
}
{% for fn in ctx.fns %}
export function use{{ fn.pascal }}(): {{ fn.output_type }} | null {
    return use{{ ctx.pascal }}Context().data?.{{ fn.name }} ?? null
}
{% endfor -%}
{% endfor -%}
{% for call in calls %}
{% if call.has_input -%}
export function use{{ call.pascal }}() {
    return useMutation<Parameters<typeof call{{ call.pascal }}>[0], Awaited<ReturnType<typeof call{{ call.pascal }}>>>(call{{ call.pascal }})
}
{% else -%}
export function use{{ call.pascal }}() {
    return useMutation<void, Awaited<ReturnType<typeof call{{ call.pascal }}>>>(() => call{{ call.pascal }}() as any)
}
{% endif -%}
{% endfor %}
// ── MizanContext root provider ──

export interface MizanContextProps {
    /** Base URL for protocol endpoints. Defaults to "/api/mizan". */
    baseUrl?: string
    /** Set to `false` for backends without a `/session/` endpoint (e.g. FastAPI). */
    session?: boolean
    children: ReactNode
}

/**
 * Root provider — calls configure() once and mounts the global context (if defined).
 * Must wrap any component using Mizan-generated hooks.
 */
export function MizanContext({ baseUrl, session, children }: MizanContextProps) {
    const configured = useRef(false)
    if (!configured.current) {
        const opts: Parameters<typeof configure>[0] = {}
        if (baseUrl !== undefined) opts.baseUrl = baseUrl
        if (session !== undefined) opts.session = session
        if (Object.keys(opts).length > 0) configure(opts)
        configured.current = true
    }
{%- if has_global %}
    return <GlobalContextProvider>{children}</GlobalContextProvider>
{%- else %}
    return <>{children}</>
{%- endif %}
}

// ── Imperative escape hatch ──

/**
 * Returns the imperative kernel API. For test harnesses or rare cases where
 * a typed generated hook does not fit. Most app code should use the typed hooks.
 */
export function useMizan() {
    return { call: mizanCall, fetch: mizanFetch }
}

export type { ContextState } from '@mizan/base'
export { configure, initSession, MizanError } from '@mizan/base'