atmx-react 0.43.0 → 0.47.0

package/dist/index.d.mts

@@ -0,0 +1,135 @@
+import * as atmx_web from 'atmx-web';
+import { AxiomError, AtmxConfig } from 'atmx-web';
+export { AtmxConfig, AxiomError, AxiomResponse, clearAuthToken, setAuthToken } from 'atmx-web';
+import * as React$1 from 'react';
+import React__default, { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface AxiomQueryDef<T> {
+    namespace: string;
+    name: string;
+    endpointId: number;
+    method: string;
+    path: string;
+    payload?: any;
+    decoder: (json: any) => T;
+    serializer?: (payload: any) => any;
+    args: Record<string, any>;
+    isStream?: boolean;
+    headers?: Record<string, string>;
+}
+type AxiomStatus = "idle" | "loading" | "success" | "error";
+interface AxiomState<T> {
+    status: AxiomStatus;
+    data: T | null;
+    error: AxiomError | null;
+    isFetching: boolean;
+    isMutating: boolean;
+    source: "cache" | "network" | null;
+}
+
+interface AxiomContextState {
+    isReady: boolean;
+    error: Error | null;
+    config: AtmxConfig | null;
+}
+declare const AxiomContext: React__default.Context<AxiomContextState | undefined>;
+interface AxiomProviderProps {
+    configUrl?: string;
+    config?: AtmxConfig;
+    children: ReactNode;
+    fallback?: ReactNode;
+}
+declare const AxiomProvider: React__default.FC<AxiomProviderProps>;
+
+declare const AxiomDataContext: React$1.Context<AxiomState<any> | null>;
+/**
+ * Throwing version: Use this when you absolutely expect to be inside a scope.
+ */
+declare function useAxiomContext<T>(): AxiomState<T>;
+/**
+ * Safe version: Returns T or an empty object.
+ * Used for Context Inheritance ($data access).
+ */
+declare function useAxiomData<T>(): T;
+
+interface AxQueryProps<T> {
+    call: AxiomQueryDef<T>;
+    children: ReactNode | ((props: {
+        data: T | null;
+        state: AxiomState<T>;
+        refetch: () => void;
+    }) => ReactNode);
+    enabled?: boolean;
+}
+declare function AxQuery<T>({ call, children, enabled, }: AxQueryProps<T>): react_jsx_runtime.JSX.Element;
+
+interface AxWhenProps {
+    /** Explicit state object from a hook (e.g. sdk.users.useGetUser) */
+    value?: {
+        status: string;
+        data?: any;
+        isFetching?: boolean;
+        isMutating?: boolean;
+    };
+    /** Comma-separated states: "idle, loading, mutating, data, success, error" */
+    is: string;
+    children: ReactNode;
+}
+declare function AxWhen({ value, is, children }: AxWhenProps): react_jsx_runtime.JSX.Element | null;
+
+interface AxTriggerProps {
+    onTrigger: () => void;
+    once?: boolean;
+    children?: ReactNode;
+}
+declare const AxTrigger: React.FC<AxTriggerProps>;
+
+declare const useAxiom: () => AxiomContextState;
+
+declare function useAxiomQuery<T>(queryDef: AxiomQueryDef<T>, options?: {
+    enabled?: boolean;
+}): {
+    data: T | null;
+    isLoading: boolean;
+    isFetching: boolean;
+    source: "cache" | "network" | null;
+    error: atmx_web.AxiomError | null;
+    state: AxiomState<T>;
+    refetch: () => void;
+};
+
+declare function useAxiomMutation<T, A>(mutationFn: (args: A) => AxiomQueryDef<T>): {
+    execute: (args: A, options?: {
+        headers?: Record<string, string>;
+    }) => Promise<void>;
+    state: AxiomState<T>;
+    data: T | null;
+    isMutating: boolean;
+    error: atmx_web.AxiomError | null;
+    getFieldError: (fieldName: string) => string | null;
+};
+
+type Listener<T> = (state: AxiomState<T>) => void;
+declare class ActiveQuery<T> {
+    queryKey: string;
+    def: AxiomQueryDef<T>;
+    private state;
+    private listeners;
+    private currentReqId;
+    constructor(queryKey: string, def: AxiomQueryDef<T>);
+    getState(): AxiomState<T>;
+    subscribe(listener: Listener<T>): () => void;
+    private updateState;
+    fetch(force?: boolean, debug?: boolean): void;
+}
+
+declare class QueryManager {
+    private queries;
+    private buildKey;
+    getQuery<T>(def: AxiomQueryDef<T>): ActiveQuery<T>;
+    invalidate(namespace: string, endpointId: number, args: Record<string, any>): void;
+}
+declare const axiomQueryManager: QueryManager;
+
+export { AxQuery, AxTrigger, AxWhen, AxiomContext, AxiomDataContext, AxiomProvider, type AxiomQueryDef, type AxiomState, type AxiomStatus, axiomQueryManager, useAxiom, useAxiomContext, useAxiomData, useAxiomMutation, useAxiomQuery };

package/dist/index.d.ts

@@ -0,0 +1,135 @@
+import * as atmx_web from 'atmx-web';
+import { AxiomError, AtmxConfig } from 'atmx-web';
+export { AtmxConfig, AxiomError, AxiomResponse, clearAuthToken, setAuthToken } from 'atmx-web';
+import * as React$1 from 'react';
+import React__default, { ReactNode } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface AxiomQueryDef<T> {
+    namespace: string;
+    name: string;
+    endpointId: number;
+    method: string;
+    path: string;
+    payload?: any;
+    decoder: (json: any) => T;
+    serializer?: (payload: any) => any;
+    args: Record<string, any>;
+    isStream?: boolean;
+    headers?: Record<string, string>;
+}
+type AxiomStatus = "idle" | "loading" | "success" | "error";
+interface AxiomState<T> {
+    status: AxiomStatus;
+    data: T | null;
+    error: AxiomError | null;
+    isFetching: boolean;
+    isMutating: boolean;
+    source: "cache" | "network" | null;
+}
+
+interface AxiomContextState {
+    isReady: boolean;
+    error: Error | null;
+    config: AtmxConfig | null;
+}
+declare const AxiomContext: React__default.Context<AxiomContextState | undefined>;
+interface AxiomProviderProps {
+    configUrl?: string;
+    config?: AtmxConfig;
+    children: ReactNode;
+    fallback?: ReactNode;
+}
+declare const AxiomProvider: React__default.FC<AxiomProviderProps>;
+
+declare const AxiomDataContext: React$1.Context<AxiomState<any> | null>;
+/**
+ * Throwing version: Use this when you absolutely expect to be inside a scope.
+ */
+declare function useAxiomContext<T>(): AxiomState<T>;
+/**
+ * Safe version: Returns T or an empty object.
+ * Used for Context Inheritance ($data access).
+ */
+declare function useAxiomData<T>(): T;
+
+interface AxQueryProps<T> {
+    call: AxiomQueryDef<T>;
+    children: ReactNode | ((props: {
+        data: T | null;
+        state: AxiomState<T>;
+        refetch: () => void;
+    }) => ReactNode);
+    enabled?: boolean;
+}
+declare function AxQuery<T>({ call, children, enabled, }: AxQueryProps<T>): react_jsx_runtime.JSX.Element;
+
+interface AxWhenProps {
+    /** Explicit state object from a hook (e.g. sdk.users.useGetUser) */
+    value?: {
+        status: string;
+        data?: any;
+        isFetching?: boolean;
+        isMutating?: boolean;
+    };
+    /** Comma-separated states: "idle, loading, mutating, data, success, error" */
+    is: string;
+    children: ReactNode;
+}
+declare function AxWhen({ value, is, children }: AxWhenProps): react_jsx_runtime.JSX.Element | null;
+
+interface AxTriggerProps {
+    onTrigger: () => void;
+    once?: boolean;
+    children?: ReactNode;
+}
+declare const AxTrigger: React.FC<AxTriggerProps>;
+
+declare const useAxiom: () => AxiomContextState;
+
+declare function useAxiomQuery<T>(queryDef: AxiomQueryDef<T>, options?: {
+    enabled?: boolean;
+}): {
+    data: T | null;
+    isLoading: boolean;
+    isFetching: boolean;
+    source: "cache" | "network" | null;
+    error: atmx_web.AxiomError | null;
+    state: AxiomState<T>;
+    refetch: () => void;
+};
+
+declare function useAxiomMutation<T, A>(mutationFn: (args: A) => AxiomQueryDef<T>): {
+    execute: (args: A, options?: {
+        headers?: Record<string, string>;
+    }) => Promise<void>;
+    state: AxiomState<T>;
+    data: T | null;
+    isMutating: boolean;
+    error: atmx_web.AxiomError | null;
+    getFieldError: (fieldName: string) => string | null;
+};
+
+type Listener<T> = (state: AxiomState<T>) => void;
+declare class ActiveQuery<T> {
+    queryKey: string;
+    def: AxiomQueryDef<T>;
+    private state;
+    private listeners;
+    private currentReqId;
+    constructor(queryKey: string, def: AxiomQueryDef<T>);
+    getState(): AxiomState<T>;
+    subscribe(listener: Listener<T>): () => void;
+    private updateState;
+    fetch(force?: boolean, debug?: boolean): void;
+}
+
+declare class QueryManager {
+    private queries;
+    private buildKey;
+    getQuery<T>(def: AxiomQueryDef<T>): ActiveQuery<T>;
+    invalidate(namespace: string, endpointId: number, args: Record<string, any>): void;
+}
+declare const axiomQueryManager: QueryManager;
+
+export { AxQuery, AxTrigger, AxWhen, AxiomContext, AxiomDataContext, AxiomProvider, type AxiomQueryDef, type AxiomState, type AxiomStatus, axiomQueryManager, useAxiom, useAxiomContext, useAxiomData, useAxiomMutation, useAxiomQuery };