@flight-framework/core 0.2.4 → 0.2.5

package/dist/react/index.d.ts

@@ -0,0 +1,73 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { FlightError } from '../errors/index.js';
+
+/**
+ * Error context value
+ */
+interface ErrorContextValue {
+    /** Current error, if any */
+    error: FlightError | null;
+    /** Clear the current error */
+    clearError: (options?: {
+        redirect?: string;
+    }) => void;
+    /** Whether an error is currently active */
+    hasError: boolean;
+}
+/**
+ * Error provider props
+ */
+interface ErrorProviderProps {
+    children: ReactNode;
+    /** Called when an error occurs */
+    onError?: (error: FlightError) => void;
+    /** Called when error is cleared */
+    onClear?: () => void;
+}
+declare const ErrorContext: react.Context<ErrorContextValue | null>;
+/**
+ * Error context provider for React applications.
+ *
+ * Wraps your app to provide error state management via useError() hook.
+ *
+ * @example
+ * ```tsx
+ * import { ErrorProvider } from '@flight-framework/core/react';
+ *
+ * function App() {
+ *     return (
+ *         <ErrorProvider onError={(e) => console.log('Error:', e)}>
+ *             <MyApp />
+ *         </ErrorProvider>
+ *     );
+ * }
+ * ```
+ */
+declare function ErrorProvider({ children, onError, onClear }: ErrorProviderProps): ReactNode;
+/**
+ * Access the current error state from anywhere in your React app.
+ *
+ * Returns null values if used outside of ErrorProvider (non-breaking behavior).
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *     const { error, clearError, hasError } = useError();
+ *
+ *     if (hasError) {
+ *         return (
+ *             <div>
+ *                 <p>Error: {error?.message}</p>
+ *                 <button onClick={() => clearError()}>Dismiss</button>
+ *             </div>
+ *         );
+ *     }
+ *
+ *     return <div>Normal content</div>;
+ * }
+ * ```
+ */
+declare function useError(): ErrorContextValue;
+
+export { ErrorContext, type ErrorContextValue, ErrorProvider, type ErrorProviderProps, useError };

package/dist/react/index.js

@@ -0,0 +1,52 @@
+import { getError, clearError } from '../chunk-FSJNOPYE.js';
+import '../chunk-YHEVHRLH.js';
+import { createContext, useState, useEffect, useCallback, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var ErrorContext = createContext(null);
+function ErrorProvider({ children, onError, onClear }) {
+  const [error, setError] = useState(() => getError());
+  useEffect(() => {
+    const handleError = (event) => {
+      setError(event.detail);
+      onError?.(event.detail);
+    };
+    const handleClear = () => {
+      setError(null);
+      onClear?.();
+    };
+    window.addEventListener("flight:error", handleError);
+    window.addEventListener("flight:error-clear", handleClear);
+    return () => {
+      window.removeEventListener("flight:error", handleError);
+      window.removeEventListener("flight:error-clear", handleClear);
+    };
+  }, [onError, onClear]);
+  const clearError2 = useCallback((options) => {
+    clearError(options);
+    setError(null);
+    onClear?.();
+  }, [onClear]);
+  const value = {
+    error,
+    clearError: clearError2,
+    hasError: error !== null
+  };
+  return /* @__PURE__ */ jsx(ErrorContext.Provider, { value, children });
+}
+function useError() {
+  const context = useContext(ErrorContext);
+  if (!context) {
+    return {
+      error: null,
+      clearError: () => {
+      },
+      hasError: false
+    };
+  }
+  return context;
+}
+
+export { ErrorContext, ErrorProvider, useError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/hooks/useError.tsx"],"names":["clearError"],"mappings":";;;;;AA0CA,IAAM,YAAA,GAAe,cAAwC,IAAI;AAwB1D,SAAS,aAAA,CAAc,EAAE,QAAA,EAAU,OAAA,EAAS,SAAQ,EAAkC;AACzF,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,IAAI,QAAA,CAA6B,MAAM,UAAU,CAAA;AAGvE,EAAA,SAAA,CAAU,MAAM;AACZ,IAAA,MAAM,WAAA,GAAc,CAAC,KAAA,KAAoC;AACrD,MAAA,QAAA,CAAS,MAAM,MAAM,CAAA;AACrB,MAAA,OAAA,GAAU,MAAM,MAAM,CAAA;AAAA,IAC1B,CAAA;AAEA,IAAA,MAAM,cAAc,MAAM;AACtB,MAAA,QAAA,CAAS,IAAI,CAAA;AACb,MAAA,OAAA,IAAU;AAAA,IACd,CAAA;AAEA,IAAA,MAAA,CAAO,gBAAA,CAAiB,gBAAgB,WAA4B,CAAA;AACpE,IAAA,MAAA,CAAO,gBAAA,CAAiB,sBAAsB,WAAW,CAAA;AAEzD,IAAA,OAAO,MAAM;AACT,MAAA,MAAA,CAAO,mBAAA,CAAoB,gBAAgB,WAA4B,CAAA;AACvE,MAAA,MAAA,CAAO,mBAAA,CAAoB,sBAAsB,WAAW,CAAA;AAAA,IAChE,CAAA;AAAA,EACJ,CAAA,EAAG,CAAC,OAAA,EAAS,OAAO,CAAC,CAAA;AAErB,EAAA,MAAMA,WAAAA,GAAa,WAAA,CAAY,CAAC,OAAA,KAAoC;AAChE,IAAA,UAAA,CAAiB,OAAO,CAAA;AACxB,IAAA,QAAA,CAAS,IAAI,CAAA;AACb,IAAA,OAAA,IAAU;AAAA,EACd,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAEZ,EAAA,MAAM,KAAA,GAA2B;AAAA,IAC7B,KAAA;AAAA,IACA,UAAA,EAAAA,WAAAA;AAAA,IACA,UAAU,KAAA,KAAU;AAAA,GACxB;AAEA,EAAA,uBACI,GAAA,CAAC,YAAA,CAAa,QAAA,EAAb,EAAsB,OAClB,QAAA,EACL,CAAA;AAER;AA6BO,SAAS,QAAA,GAA8B;AAC1C,EAAA,MAAM,OAAA,GAAU,WAAW,YAAY,CAAA;AAIvC,EAAA,IAAI,CAAC,OAAA,EAAS;AACV,IAAA,OAAO;AAAA,MACH,KAAA,EAAO,IAAA;AAAA,MACP,YAAY,MAAM;AAAA,MAAE,CAAA;AAAA,MACpB,QAAA,EAAU;AAAA,KACd;AAAA,EACJ;AAEA,EAAA,OAAO,OAAA;AACX","file":"index.js","sourcesContent":["/**\r\n * @flight-framework/core - React Error Hook\r\n * \r\n * Optional React hook for accessing error state.\r\n * Developers can use this or bring their own solution.\r\n */\r\n\r\nimport { createContext, useContext, useState, useEffect, useCallback } from 'react';\r\nimport type { ReactNode } from 'react';\r\nimport { FlightError, getError, clearError as clearGlobalError } from '../../errors/index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Error context value\r\n */\r\nexport interface ErrorContextValue {\r\n    /** Current error, if any */\r\n    error: FlightError | null;\r\n    /** Clear the current error */\r\n    clearError: (options?: { redirect?: string }) => void;\r\n    /** Whether an error is currently active */\r\n    hasError: boolean;\r\n}\r\n\r\n/**\r\n * Error provider props\r\n */\r\nexport interface ErrorProviderProps {\r\n    children: ReactNode;\r\n    /** Called when an error occurs */\r\n    onError?: (error: FlightError) => void;\r\n    /** Called when error is cleared */\r\n    onClear?: () => void;\r\n}\r\n\r\n// ============================================================================\r\n// Context\r\n// ============================================================================\r\n\r\nconst ErrorContext = createContext<ErrorContextValue | null>(null);\r\n\r\n// ============================================================================\r\n// Provider Component\r\n// ============================================================================\r\n\r\n/**\r\n * Error context provider for React applications.\r\n * \r\n * Wraps your app to provide error state management via useError() hook.\r\n * \r\n * @example\r\n * ```tsx\r\n * import { ErrorProvider } from '@flight-framework/core/react';\r\n * \r\n * function App() {\r\n *     return (\r\n *         <ErrorProvider onError={(e) => console.log('Error:', e)}>\r\n *             <MyApp />\r\n *         </ErrorProvider>\r\n *     );\r\n * }\r\n * ```\r\n */\r\nexport function ErrorProvider({ children, onError, onClear }: ErrorProviderProps): ReactNode {\r\n    const [error, setError] = useState<FlightError | null>(() => getError());\r\n\r\n    // Listen for error events from showError()\r\n    useEffect(() => {\r\n        const handleError = (event: CustomEvent<FlightError>) => {\r\n            setError(event.detail);\r\n            onError?.(event.detail);\r\n        };\r\n\r\n        const handleClear = () => {\r\n            setError(null);\r\n            onClear?.();\r\n        };\r\n\r\n        window.addEventListener('flight:error', handleError as EventListener);\r\n        window.addEventListener('flight:error-clear', handleClear);\r\n\r\n        return () => {\r\n            window.removeEventListener('flight:error', handleError as EventListener);\r\n            window.removeEventListener('flight:error-clear', handleClear);\r\n        };\r\n    }, [onError, onClear]);\r\n\r\n    const clearError = useCallback((options?: { redirect?: string }) => {\r\n        clearGlobalError(options);\r\n        setError(null);\r\n        onClear?.();\r\n    }, [onClear]);\r\n\r\n    const value: ErrorContextValue = {\r\n        error,\r\n        clearError,\r\n        hasError: error !== null,\r\n    };\r\n\r\n    return (\r\n        <ErrorContext.Provider value={value} >\r\n            {children}\r\n        </ErrorContext.Provider>\r\n    );\r\n}\r\n\r\n// ============================================================================\r\n// Hook\r\n// ============================================================================\r\n\r\n/**\r\n * Access the current error state from anywhere in your React app.\r\n * \r\n * Returns null values if used outside of ErrorProvider (non-breaking behavior).\r\n * \r\n * @example\r\n * ```tsx\r\n * function MyComponent() {\r\n *     const { error, clearError, hasError } = useError();\r\n *     \r\n *     if (hasError) {\r\n *         return (\r\n *             <div>\r\n *                 <p>Error: {error?.message}</p>\r\n *                 <button onClick={() => clearError()}>Dismiss</button>\r\n *             </div>\r\n *         );\r\n *     }\r\n *     \r\n *     return <div>Normal content</div>;\r\n * }\r\n * ```\r\n */\r\nexport function useError(): ErrorContextValue {\r\n    const context = useContext(ErrorContext);\r\n\r\n    // Return safe defaults if used outside provider\r\n    // This allows the hook to be used without forcing ErrorProvider\r\n    if (!context) {\r\n        return {\r\n            error: null,\r\n            clearError: () => { },\r\n            hasError: false,\r\n        };\r\n    }\r\n\r\n    return context;\r\n}\r\n\r\n// ============================================================================\r\n// Re-exports for convenience\r\n// ============================================================================\r\n\r\nexport { ErrorContext };\r\n"]}

package/dist/rsc/adapters/index.js

@@ -1,7 +1,7 @@
 import '../../chunk-Y22AMGTM.js';
-export { createPreactAdapter, createPreactConsumer, markAsPreactClientComponent, lazy as preactLazy } from '../../chunk-MDQNNIHH.js';
 export { createReactAdapter, createReactConsumer, markAsClientComponent } from '../../chunk-TASAT7KB.js';
 export { createVueAdapter, createVueConsumer, markAsVueClientComponent } from '../../chunk-2F2QU6RC.js';
 export { createSolidAdapter, createSolidConsumer, isServer as isSolidServer, markAsSolidClientComponent } from '../../chunk-VPFMHGEV.js';
+export { createPreactAdapter, createPreactConsumer, markAsPreactClientComponent, lazy as preactLazy } from '../../chunk-MDQNNIHH.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/rsc/index.js

@@ -1,15 +1,15 @@
 import '../chunk-63SCEXD7.js';
+export { acceptsJson, createServerContext, deleteCookie, getHeader, getHeaders, getPreferredLanguage, getRedirectInfo, isAjaxRequest, isBotRequest, isMutationRequest, isNotFoundError, isRedirectError, notFound, redirect, setCacheControl, setCookie, supportsStreaming } from '../chunk-62C7LX2E.js';
 export { FlightStreamError, consumeFlightStream, createFlightResponse, createFlightStream, createFlightStreamFromArray, createHybridResponse, createStreamController, mergeFlightStreams, parseFlightStream, parseFlightStreamSync, prettyPrintChunks, transformFlightStream } from '../chunk-PVUMB632.js';
 export { FlightRenderer, createRenderer, renderServerComponent, renderServerComponentStreaming } from '../chunk-P6WSBVDT.js';
+export { FlightPayloadError, FlightSerializationError, clientRef, createActionChunk, createClientChunk, createErrorChunk, createHintChunk, createServerChunk, deserialize, fragment, generateChunkId, h, isFlightElement, resetChunkIdCounter, serialize, suspense, text, toFlightElement } from '../chunk-K2CQZPCG.js';
 export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError as legacyIsNotFoundError, isRedirectError as legacyIsRedirectError, notFound as legacyNotFound, redirect as legacyRedirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withErrorBoundary } from '../chunk-3ZSSRE6M.js';
 export { flightRSC } from '../chunk-ZIE56LCA.js';
+export { BoundaryRegistry, CLIENT_REFERENCE, SERVER_REFERENCE, analyzeModule, createClientReference, createServerReference, detectAsyncComponents, detectBoundaryType, detectInlineServerActions, getReferenceId, globalRegistry, hasUseClientDirective, hasUseServerDirective, isClientReference, isServerReference, registerClientComponent, registerServerAction } from '../chunk-PDW5WCMW.js';
 import '../chunk-Y22AMGTM.js';
-import '../chunk-MDQNNIHH.js';
 export { createReactAdapter, createReactConsumer, markAsClientComponent } from '../chunk-TASAT7KB.js';
 import '../chunk-2F2QU6RC.js';
 import '../chunk-VPFMHGEV.js';
-export { FlightPayloadError, FlightSerializationError, clientRef, createActionChunk, createClientChunk, createErrorChunk, createHintChunk, createServerChunk, deserialize, fragment, generateChunkId, h, isFlightElement, resetChunkIdCounter, serialize, suspense, text, toFlightElement } from '../chunk-K2CQZPCG.js';
-export { BoundaryRegistry, CLIENT_REFERENCE, SERVER_REFERENCE, analyzeModule, createClientReference, createServerReference, detectAsyncComponents, detectBoundaryType, detectInlineServerActions, getReferenceId, globalRegistry, hasUseClientDirective, hasUseServerDirective, isClientReference, isServerReference, registerClientComponent, registerServerAction } from '../chunk-PDW5WCMW.js';
-export { acceptsJson, createServerContext, deleteCookie, getHeader, getHeaders, getPreferredLanguage, getRedirectInfo, isAjaxRequest, isBotRequest, isMutationRequest, isNotFoundError, isRedirectError, notFound, redirect, setCacheControl, setCookie, supportsStreaming } from '../chunk-62C7LX2E.js';
+import '../chunk-MDQNNIHH.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/server/index.js

@@ -1,6 +1,6 @@
-export { createServer, getRuntime, isFlightServer } from '../chunk-VOBQDQKX.js';
+export { createServer, getRuntime, isFlightServer } from '../chunk-LBYDTULN.js';
+import '../chunk-IXMD5QH2.js';
 import '../chunk-GCQZ4FHI.js';
 import '../chunk-KWFX6WHG.js';
-import '../chunk-IXMD5QH2.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/utils/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @flight-framework/core - Environment Utilities
+ *
+ * Environment detection utilities that work across Node.js, browsers, and edge runtimes.
+ * No hardcoded values - detects environment dynamically.
+ */
+/**
+ * Check if running in production environment.
+ *
+ * Detection order:
+ * 1. Node.js process.env.NODE_ENV
+ * 2. Vite/modern bundlers import.meta.env.MODE or import.meta.env.PROD
+ * 3. Default: false (not production)
+ */
+declare function isProduction(): boolean;
+/**
+ * Check if running in development environment.
+ *
+ * Detection order:
+ * 1. Node.js process.env.NODE_ENV
+ * 2. Vite/modern bundlers import.meta.env.MODE or import.meta.env.DEV
+ * 3. Default: true (assume development if unknown)
+ */
+declare function isDevelopment(): boolean;
+/**
+ * Check if running in test environment.
+ */
+declare function isTest(): boolean;
+/**
+ * Check if running on the server (not browser).
+ */
+declare function isServer(): boolean;
+/**
+ * Check if running in the browser.
+ */
+declare function isBrowser(): boolean;
+/**
+ * Get the current environment name.
+ */
+declare function getEnvironment(): 'production' | 'development' | 'test' | 'unknown';
+
+export { getEnvironment, isBrowser, isDevelopment, isProduction, isServer, isTest };

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+import '../chunk-PL37KFRJ.js';
+export { getEnvironment, isBrowser, isDevelopment, isProduction, isServer, isTest } from '../chunk-YHEVHRLH.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@flight-framework/core",
-    "version": "0.2.4",
+    "version": "0.2.5",
     "description": "Core primitives for Flight Framework - routing, rendering, caching",
     "keywords": [
         "flight",