@theruntimehq/react 0.1.2 → 0.2.1

package/README.md

@@ -14,6 +14,20 @@ This SDK is a **pure state management SDK** with:
 
 ---
 
+## Table of Contents
+
+- [Installation](#installation)
+- [Core Hooks & Provider APIs](#core-hooks--provider-apis)
+  - [1. Global Provider (\`RuntimeHQProvider\`)](#1-global-provider-runtimehqprovider)
+  - [2. Context Hook (\`useRuntimeHQ\`)](#2-context-hook-useruntimehq)
+  - [3. Standalone Direct Hook (\`useRuntimeHQState\`)](#3-standalone-direct-hook-useruntimehqstate)
+- [Convenience Helpers](#convenience-helpers)
+- [Server Rendering (SSR) & Next.js App Router Integration](#server-rendering-ssr--nextjs-app-router-integration)
+- [Examples Directory](#examples-directory)
+- [License](#license)
+
+---
+
 ## Installation
 
 Ensure you have `@theruntimehq/js` and React installed in your project:
@@ -112,7 +126,7 @@ function IndependentWidget() {
 
 ## Convenience Helpers
 
-Quickly determine states using utility checkers. These accept either the full `RuntimeResponse` object, the `RuntimeState` string, or `null`/`undefined`.
+Quickly determine states using utility checkers. These accept either the full `RuntimeResponse` object, a `CapabilityState` object, the `RuntimeState` string, or `null`/`undefined`.
 
 ```typescript
 import { 
@@ -197,6 +211,36 @@ export default function ClientSidePoller({ initialData }: ClientSidePollerProps)
 }
 ```
 
+## Examples Directory
+
+Check out the [examples directory](./examples) for common integration patterns:
+
+| File Name | Business Outcome |
+| :--- | :--- |
+| `01-application-wide-banner.tsx` | Inform all users when the application is degraded, under maintenance, or unavailable. |
+| `02-capability-outage-tooltip.tsx` | Explain why a specific feature is unavailable. |
+| `03-feature-gating.tsx` | Hide unavailable functionality from users. |
+| `04-disable-checkout-when-payments-down.tsx` | Prevent purchases when the payments capability is unavailable. |
+| `05-disable-document-upload-during-maintenance.tsx` | Prevent uploads while the upload capability is under maintenance. |
+| `06-read-only-mode-during-outage.tsx` | Keep the application usable while blocking write operations. |
+| `07-degraded-experience-message.tsx` | Communicate reduced functionality without blocking users. |
+| `08-runtime-status-indicator.tsx` | Show operational status in the application header, footer, or navigation. |
+| `09-customer-facing-status-page.tsx` | Build a public status page powered by RuntimeHQ. |
+| `10-runtime-aware-navigation.tsx` | Hide or disable navigation items for unavailable capabilities. |
+| `11-runtime-aware-routing.tsx` | Prevent access to routes backed by unavailable capabilities. |
+| `12-runtime-aware-redirection.tsx` | Automatically redirect users when a capability becomes unavailable. |
+| `13-runtime-aware-fallback-route.tsx` | Redirect users to an alternative workflow when the primary capability is unavailable. |
+| `14-outage-toast-notifications.tsx` | Notify users immediately when runtime state changes occur. |
+| `15-runtime-dashboard.tsx` | Build an operational dashboard displaying application health and capability health. |
+| `16-multi-application-operations-center.tsx` | Monitor multiple applications from a unified screen. |
+| `17-runtime-aware-error-page.tsx` | Replace generic errors with operationally-aware messaging. |
+| `18-runtime-aware-empty-state.tsx` | Show meaningful empty states when functionality is unavailable. |
+| `19-maintenance-lock-screen.tsx` | Restrict access to workflows during active maintenance windows. |
+| `20-live-system-health-widget.tsx` | Embed a reusable health widget anywhere in the application. |
+| `21-production-ready-provider.tsx` | Complete production integration including provider setup, refresh handling, and resilience patterns. |
+
+---
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -0,0 +1,173 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let react = require("react");
+react = __toESM(react);
+let _theruntimehq_js = require("@theruntimehq/js");
+let react_jsx_runtime = require("react/jsx-runtime");
+
+//#region src/context/index.ts
+const RuntimeHQContext = (0, react.createContext)(null);
+
+//#endregion
+//#region src/hooks/useRuntimeHQState.ts
+/**
+* A direct React hook to fetch and watch RuntimeHQ status without using a Context Provider.
+*/
+function useRuntimeHQState(options) {
+	const { runtimeKey, intervalSeconds = 15 } = options;
+	const [client, clientInitError] = (0, react.useMemo)(() => {
+		if (!runtimeKey) return [null, /* @__PURE__ */ new Error("runtimeKey is required")];
+		try {
+			return [new _theruntimehq_js.RuntimeHQClient({ runtimeKey }), null];
+		} catch (err) {
+			return [null, err instanceof Error ? err : new Error(String(err))];
+		}
+	}, [runtimeKey]);
+	const [runtime, setRuntime] = (0, react.useState)(null);
+	const [error, setError] = (0, react.useState)(clientInitError || null);
+	const [loading, setLoading] = (0, react.useState)(!clientInitError);
+	(0, react.useEffect)(() => {
+		if (clientInitError) {
+			setError(clientInitError);
+			setLoading(false);
+			return;
+		}
+		if (!client) return;
+		setRuntime(null);
+		setError(null);
+		setLoading(true);
+		let active = true;
+		const unsubscribe = client.watchRuntime({
+			intervalSeconds,
+			onUpdate: (data) => {
+				if (active) {
+					setRuntime(data);
+					setError(null);
+					setLoading(false);
+				}
+			},
+			onError: (err) => {
+				if (active) {
+					setError(err);
+					setLoading(false);
+				}
+			}
+		});
+		return () => {
+			active = false;
+			unsubscribe();
+		};
+	}, [
+		client,
+		clientInitError,
+		intervalSeconds
+	]);
+	return {
+		runtime,
+		loading,
+		error,
+		hasCapability: (0, react.useCallback)((name) => {
+			return runtime ? runtime.hasCapability(name) : false;
+		}, [runtime]),
+		getCapabilityState: (0, react.useCallback)((name) => {
+			return runtime ? runtime.getCapabilityState(name) : void 0;
+		}, [runtime])
+	};
+}
+
+//#endregion
+//#region src/provider/index.tsx
+/**
+* Context Provider that manages a global RuntimeHQ client subscription and polling loop,
+* making the status state available to all child components using `useRuntimeHQ()`.
+*/
+function RuntimeHQProvider({ runtimeKey, intervalSeconds, children }) {
+	const value = useRuntimeHQState({
+		runtimeKey,
+		intervalSeconds
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RuntimeHQContext.Provider, {
+		value,
+		children
+	});
+}
+
+//#endregion
+//#region src/hooks/useRuntimeHQ.ts
+/**
+* Accesses the global RuntimeHQ status check context.
+* Must be used within a `<RuntimeHQProvider>`.
+*/
+function useRuntimeHQ() {
+	const context = (0, react.useContext)(RuntimeHQContext);
+	if (!context) throw new Error("useRuntimeHQ must be used within a RuntimeHQProvider");
+	return context;
+}
+
+//#endregion
+//#region src/helpers/index.ts
+function getState(input) {
+	if (!input) return null;
+	if (typeof input === "string") return input;
+	return input.state || null;
+}
+/**
+* Checks if the application runtime status is OPERATIONAL.
+*/
+function isOperational(input) {
+	return getState(input) === "OPERATIONAL";
+}
+/**
+* Checks if the application runtime status is MAINTENANCE.
+*/
+function isMaintenance(input) {
+	return getState(input) === "MAINTENANCE";
+}
+/**
+* Checks if the application runtime status is DEGRADED.
+*/
+function isDegraded(input) {
+	return getState(input) === "DEGRADED";
+}
+/**
+* Checks if the application runtime status is OUTAGE.
+*/
+function isOutage(input) {
+	return getState(input) === "OUTAGE";
+}
+
+//#endregion
+exports.RuntimeHQProvider = RuntimeHQProvider;
+exports.isDegraded = isDegraded;
+exports.isMaintenance = isMaintenance;
+exports.isOperational = isOperational;
+exports.isOutage = isOutage;
+exports.useRuntimeHQ = useRuntimeHQ;
+exports.useRuntimeHQState = useRuntimeHQState;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["RuntimeHQClient"],"sources":["../src/context/index.ts","../src/hooks/useRuntimeHQState.ts","../src/provider/index.tsx","../src/hooks/useRuntimeHQ.ts","../src/helpers/index.ts"],"sourcesContent":["\"use client\";\n\nimport { createContext } from \"react\";\nimport { RuntimeHQContextValue } from \"../types\";\n\nexport const RuntimeHQContext = createContext<RuntimeHQContextValue | null>(null);\n","\"use client\";\n\nimport { useState, useEffect, useMemo, useCallback } from \"react\";\nimport { RuntimeHQClient } from \"@theruntimehq/js\";\nimport { RuntimeResponse, RuntimeHQContextValue } from \"../types\";\n\nexport interface UseRuntimeHQStateOptions {\n  runtimeKey: string;\n  intervalSeconds?: number;\n}\n\n/**\n * A direct React hook to fetch and watch RuntimeHQ status without using a Context Provider.\n */\nexport function useRuntimeHQState(options: UseRuntimeHQStateOptions): RuntimeHQContextValue {\n  const { runtimeKey, intervalSeconds = 15 } = options;\n\n  // Safely instantiate RuntimeHQClient\n  const [client, clientInitError] = useMemo(() => {\n    if (!runtimeKey) {\n      return [null, new Error(\"runtimeKey is required\")] as const;\n    }\n    try {\n      return [new RuntimeHQClient({ runtimeKey }), null] as const;\n    } catch (err) {\n      return [null, err instanceof Error ? err : new Error(String(err))] as const;\n    }\n  }, [runtimeKey]);\n\n  const [runtime, setRuntime] = useState<RuntimeResponse | null>(null);\n  const [error, setError] = useState<Error | null>(clientInitError || null);\n  const [loading, setLoading] = useState<boolean>(!clientInitError);\n\n  useEffect(() => {\n    if (clientInitError) {\n      setError(clientInitError);\n      setLoading(false);\n      return;\n    }\n\n    if (!client) {\n      return;\n    }\n\n    // Reset states when the client or key changes\n    setRuntime(null);\n    setError(null);\n    setLoading(true);\n\n    let active = true;\n\n    const unsubscribe = client.watchRuntime({\n      intervalSeconds,\n      onUpdate: (data) => {\n        if (active) {\n          setRuntime(data);\n          setError(null);\n          setLoading(false);\n        }\n      },\n      onError: (err) => {\n        if (active) {\n          setError(err);\n          setLoading(false);\n        }\n      },\n    });\n\n    return () => {\n      active = false;\n      unsubscribe();\n    };\n  }, [client, clientInitError, intervalSeconds]);\n\n  const hasCapability = useCallback((name: string) => {\n    return runtime ? runtime.hasCapability(name) : false;\n  }, [runtime]);\n\n  const getCapabilityState = useCallback((name: string) => {\n    return runtime ? runtime.getCapabilityState(name) : undefined;\n  }, [runtime]);\n\n  return {\n    runtime,\n    loading,\n    error,\n    hasCapability,\n    getCapabilityState,\n  };\n}\n","\"use client\";\n\nimport React from \"react\";\nimport { RuntimeHQContext } from \"../context\";\nimport { useRuntimeHQState } from \"../hooks/useRuntimeHQState\";\n\nexport interface RuntimeHQProviderProps {\n  runtimeKey: string;\n  intervalSeconds?: number;\n  children: React.ReactNode;\n}\n\n/**\n * Context Provider that manages a global RuntimeHQ client subscription and polling loop,\n * making the status state available to all child components using `useRuntimeHQ()`.\n */\nexport function RuntimeHQProvider({\n  runtimeKey,\n  intervalSeconds,\n  children,\n}: RuntimeHQProviderProps) {\n  const value = useRuntimeHQState({ runtimeKey, intervalSeconds });\n\n  return (\n    <RuntimeHQContext.Provider value={value}>\n      {children}\n    </RuntimeHQContext.Provider>\n  );\n}\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport { RuntimeHQContext } from \"../context\";\nimport { RuntimeHQContextValue } from \"../types\";\n\n/**\n * Accesses the global RuntimeHQ status check context.\n * Must be used within a `<RuntimeHQProvider>`.\n */\nexport function useRuntimeHQ(): RuntimeHQContextValue {\n  const context = useContext(RuntimeHQContext);\n  if (!context) {\n    throw new Error(\"useRuntimeHQ must be used within a RuntimeHQProvider\");\n  }\n  return context;\n}\n","import { RuntimeResponse, RuntimeState, CapabilityState } from \"../types\";\n\ntype StateInput = RuntimeResponse | CapabilityState | RuntimeState | null | undefined;\n\nfunction getState(input: StateInput): RuntimeState | null {\n  if (!input) return null;\n  if (typeof input === \"string\") return input;\n  return input.state || null;\n}\n\n/**\n * Checks if the application runtime status is OPERATIONAL.\n */\nexport function isOperational(input: StateInput): boolean {\n  return getState(input) === \"OPERATIONAL\";\n}\n\n/**\n * Checks if the application runtime status is MAINTENANCE.\n */\nexport function isMaintenance(input: StateInput): boolean {\n  return getState(input) === \"MAINTENANCE\";\n}\n\n/**\n * Checks if the application runtime status is DEGRADED.\n */\nexport function isDegraded(input: StateInput): boolean {\n  return getState(input) === \"DEGRADED\";\n}\n\n/**\n * Checks if the application runtime status is OUTAGE.\n */\nexport function isOutage(input: StateInput): boolean {\n  return getState(input) === \"OUTAGE\";\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,MAAa,4CAA+D,IAAI;;;;;;;ACShF,SAAgB,kBAAkB,SAA0D;CAC1F,MAAM,EAAE,YAAY,kBAAkB,OAAO;CAG7C,MAAM,CAAC,QAAQ,4CAAiC;EAC9C,IAAI,CAAC,YACH,OAAO,CAAC,sBAAM,IAAI,MAAM,wBAAwB,CAAC;EAEnD,IAAI;GACF,OAAO,CAAC,IAAIA,iCAAgB,EAAE,WAAW,CAAC,GAAG,IAAI;EACnD,SAAS,KAAK;GACZ,OAAO,CAAC,MAAM,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;EACnE;CACF,GAAG,CAAC,UAAU,CAAC;CAEf,MAAM,CAAC,SAAS,kCAA+C,IAAI;CACnE,MAAM,CAAC,OAAO,gCAAmC,mBAAmB,IAAI;CACxE,MAAM,CAAC,SAAS,kCAAgC,CAAC,eAAe;CAEhE,2BAAgB;EACd,IAAI,iBAAiB;GACnB,SAAS,eAAe;GACxB,WAAW,KAAK;GAChB;EACF;EAEA,IAAI,CAAC,QACH;EAIF,WAAW,IAAI;EACf,SAAS,IAAI;EACb,WAAW,IAAI;EAEf,IAAI,SAAS;EAEb,MAAM,cAAc,OAAO,aAAa;GACtC;GACA,WAAW,SAAS;IAClB,IAAI,QAAQ;KACV,WAAW,IAAI;KACf,SAAS,IAAI;KACb,WAAW,KAAK;IAClB;GACF;GACA,UAAU,QAAQ;IAChB,IAAI,QAAQ;KACV,SAAS,GAAG;KACZ,WAAW,KAAK;IAClB;GACF;EACF,CAAC;EAED,aAAa;GACX,SAAS;GACT,YAAY;EACd;CACF,GAAG;EAAC;EAAQ;EAAiB;CAAe,CAAC;CAU7C,OAAO;EACL;EACA;EACA;EACA,uCAZiC,SAAiB;GAClD,OAAO,UAAU,QAAQ,cAAc,IAAI,IAAI;EACjD,GAAG,CAAC,OAAO,CAUG;EACZ,4CATsC,SAAiB;GACvD,OAAO,UAAU,QAAQ,mBAAmB,IAAI,IAAI;EACtD,GAAG,CAAC,OAAO,CAOQ;CACnB;AACF;;;;;;;;ACzEA,SAAgB,kBAAkB,EAChC,YACA,iBACA,YACyB;CACzB,MAAM,QAAQ,kBAAkB;EAAE;EAAY;CAAgB,CAAC;CAE/D,OACE,2CAAC,iBAAiB,UAAlB;EAAkC;EAC/B;CACwB;AAE/B;;;;;;;;AClBA,SAAgB,eAAsC;CACpD,MAAM,gCAAqB,gBAAgB;CAC3C,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,sDAAsD;CAExE,OAAO;AACT;;;;ACZA,SAAS,SAAS,OAAwC;CACxD,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,OAAO,MAAM,SAAS;AACxB;;;;AAKA,SAAgB,cAAc,OAA4B;CACxD,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;AAKA,SAAgB,cAAc,OAA4B;CACxD,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;AAKA,SAAgB,WAAW,OAA4B;CACrD,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;AAKA,SAAgB,SAAS,OAA4B;CACnD,OAAO,SAAS,KAAK,MAAM;AAC7B"}

package/dist/index.d.cts

@@ -0,0 +1,66 @@
+import React from "react";
+import { CapabilityState, CapabilityState as CapabilityState$1, RuntimeHQClientOptions, RuntimeResponse, RuntimeResponse as RuntimeResponse$1, RuntimeState, WatchRuntimeOptions } from "@theruntimehq/js";
+
+//#region src/provider/index.d.ts
+interface RuntimeHQProviderProps {
+  runtimeKey: string;
+  intervalSeconds?: number;
+  children: React.ReactNode;
+}
+/**
+ * Context Provider that manages a global RuntimeHQ client subscription and polling loop,
+ * making the status state available to all child components using `useRuntimeHQ()`.
+ */
+declare function RuntimeHQProvider({
+  runtimeKey,
+  intervalSeconds,
+  children
+}: RuntimeHQProviderProps): React.JSX.Element;
+//#endregion
+//#region src/types/index.d.ts
+interface RuntimeHQContextValue {
+  runtime: RuntimeResponse$1 | null;
+  loading: boolean;
+  error: Error | null;
+  hasCapability: (name: string) => boolean;
+  getCapabilityState: (name: string) => CapabilityState$1 | undefined;
+}
+//#endregion
+//#region src/hooks/useRuntimeHQ.d.ts
+/**
+ * Accesses the global RuntimeHQ status check context.
+ * Must be used within a `<RuntimeHQProvider>`.
+ */
+declare function useRuntimeHQ(): RuntimeHQContextValue;
+//#endregion
+//#region src/hooks/useRuntimeHQState.d.ts
+interface UseRuntimeHQStateOptions {
+  runtimeKey: string;
+  intervalSeconds?: number;
+}
+/**
+ * A direct React hook to fetch and watch RuntimeHQ status without using a Context Provider.
+ */
+declare function useRuntimeHQState(options: UseRuntimeHQStateOptions): RuntimeHQContextValue;
+//#endregion
+//#region src/helpers/index.d.ts
+type StateInput = RuntimeResponse | CapabilityState | RuntimeState | null | undefined;
+/**
+ * Checks if the application runtime status is OPERATIONAL.
+ */
+declare function isOperational(input: StateInput): boolean;
+/**
+ * Checks if the application runtime status is MAINTENANCE.
+ */
+declare function isMaintenance(input: StateInput): boolean;
+/**
+ * Checks if the application runtime status is DEGRADED.
+ */
+declare function isDegraded(input: StateInput): boolean;
+/**
+ * Checks if the application runtime status is OUTAGE.
+ */
+declare function isOutage(input: StateInput): boolean;
+//#endregion
+export { type CapabilityState, type RuntimeHQClientOptions, RuntimeHQContextValue, RuntimeHQProvider, type RuntimeHQProviderProps, type RuntimeResponse, type RuntimeState, type UseRuntimeHQStateOptions, type WatchRuntimeOptions, isDegraded, isMaintenance, isOperational, isOutage, useRuntimeHQ, useRuntimeHQState };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/provider/index.tsx","../src/types/index.ts","../src/hooks/useRuntimeHQ.ts","../src/hooks/useRuntimeHQState.ts","../src/helpers/index.ts"],"mappings":";;;;UAMiB,sBAAA;EACf,UAAA;EACA,eAAA;EACA,QAAA,EAAU,KAAA,CAAM,SAAS;AAAA;;;;;iBAOX,iBAAA;EACd,UAAA;EACA,eAAA;EACA;AAAA,GACC,sBAAA,GAAsB,KAAA,CAAA,GAAA,CAAA,OAAA;;;UCVR,qBAAA;EACf,OAAA,EAAS,iBAAA;EACT,OAAA;EACA,KAAA,EAAO,KAAA;EACP,aAAA,GAAgB,IAAA;EAChB,kBAAA,GAAqB,IAAA,aAAiB,iBAAA;AAAA;;;;;;ADTxC;iBEIgB,YAAA,IAAgB,qBAAqB;;;UCJpC,wBAAA;EACf,UAAA;EACA,eAAe;AAAA;;;;iBAMD,iBAAA,CAAkB,OAAA,EAAS,wBAAA,GAA2B,qBAAqB;;;KCZtF,UAAA,GAAa,eAAA,GAAkB,eAAA,GAAkB,YAAA;;;AJItD;iBIOgB,aAAA,CAAc,KAAiB,EAAV,UAAU;;;;iBAO/B,aAAA,CAAc,KAAiB,EAAV,UAAU;;;;iBAO/B,UAAA,CAAW,KAAiB,EAAV,UAAU;AJlBjB;AAO3B;;AAP2B,iBIyBX,QAAA,CAAS,KAAiB,EAAV,UAAU"}

package/dist/index.d.mts

@@ -1,54 +1,66 @@
-import React from 'react';
-import { RuntimeResponse, RuntimeState } from '@theruntimehq/js';
-export { RuntimeHQClientOptions, RuntimeResponse, RuntimeSourceType, RuntimeState, WatchRuntimeOptions } from '@theruntimehq/js';
+import React from "react";
+import { CapabilityState, CapabilityState as CapabilityState$1, RuntimeHQClientOptions, RuntimeResponse, RuntimeResponse as RuntimeResponse$1, RuntimeState, WatchRuntimeOptions } from "@theruntimehq/js";
 
+//#region src/provider/index.d.ts
 interface RuntimeHQProviderProps {
-    runtimeKey: string;
-    intervalSeconds?: number;
-    children: React.ReactNode;
+  runtimeKey: string;
+  intervalSeconds?: number;
+  children: React.ReactNode;
 }
 /**
  * Context Provider that manages a global RuntimeHQ client subscription and polling loop,
  * making the status state available to all child components using `useRuntimeHQ()`.
  */
-declare function RuntimeHQProvider({ runtimeKey, intervalSeconds, children, }: RuntimeHQProviderProps): React.JSX.Element;
-
+declare function RuntimeHQProvider({
+  runtimeKey,
+  intervalSeconds,
+  children
+}: RuntimeHQProviderProps): React.JSX.Element;
+//#endregion
+//#region src/types/index.d.ts
 interface RuntimeHQContextValue {
-    runtime: RuntimeResponse | null;
-    loading: boolean;
-    error: Error | null;
+  runtime: RuntimeResponse$1 | null;
+  loading: boolean;
+  error: Error | null;
+  hasCapability: (name: string) => boolean;
+  getCapabilityState: (name: string) => CapabilityState$1 | undefined;
 }
-
+//#endregion
+//#region src/hooks/useRuntimeHQ.d.ts
 /**
  * Accesses the global RuntimeHQ status check context.
  * Must be used within a `<RuntimeHQProvider>`.
  */
 declare function useRuntimeHQ(): RuntimeHQContextValue;
-
+//#endregion
+//#region src/hooks/useRuntimeHQState.d.ts
 interface UseRuntimeHQStateOptions {
-    runtimeKey: string;
-    intervalSeconds?: number;
+  runtimeKey: string;
+  intervalSeconds?: number;
 }
 /**
  * A direct React hook to fetch and watch RuntimeHQ status without using a Context Provider.
  */
 declare function useRuntimeHQState(options: UseRuntimeHQStateOptions): RuntimeHQContextValue;
-
+//#endregion
+//#region src/helpers/index.d.ts
+type StateInput = RuntimeResponse | CapabilityState | RuntimeState | null | undefined;
 /**
  * Checks if the application runtime status is OPERATIONAL.
  */
-declare function isOperational(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean;
+declare function isOperational(input: StateInput): boolean;
 /**
  * Checks if the application runtime status is MAINTENANCE.
  */
-declare function isMaintenance(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean;
+declare function isMaintenance(input: StateInput): boolean;
 /**
  * Checks if the application runtime status is DEGRADED.
  */
-declare function isDegraded(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean;
+declare function isDegraded(input: StateInput): boolean;
 /**
  * Checks if the application runtime status is OUTAGE.
  */
-declare function isOutage(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean;
-
-export { type RuntimeHQContextValue, RuntimeHQProvider, type RuntimeHQProviderProps, type UseRuntimeHQStateOptions, isDegraded, isMaintenance, isOperational, isOutage, useRuntimeHQ, useRuntimeHQState };
+declare function isOutage(input: StateInput): boolean;
+//#endregion
+export { type CapabilityState, type RuntimeHQClientOptions, RuntimeHQContextValue, RuntimeHQProvider, type RuntimeHQProviderProps, type RuntimeResponse, type RuntimeState, type UseRuntimeHQStateOptions, type WatchRuntimeOptions, isDegraded, isMaintenance, isOperational, isOutage, useRuntimeHQ, useRuntimeHQState };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/provider/index.tsx","../src/types/index.ts","../src/hooks/useRuntimeHQ.ts","../src/hooks/useRuntimeHQState.ts","../src/helpers/index.ts"],"mappings":";;;;UAMiB,sBAAA;EACf,UAAA;EACA,eAAA;EACA,QAAA,EAAU,KAAA,CAAM,SAAS;AAAA;;;;;iBAOX,iBAAA;EACd,UAAA;EACA,eAAA;EACA;AAAA,GACC,sBAAA,GAAsB,KAAA,CAAA,GAAA,CAAA,OAAA;;;UCVR,qBAAA;EACf,OAAA,EAAS,iBAAA;EACT,OAAA;EACA,KAAA,EAAO,KAAA;EACP,aAAA,GAAgB,IAAA;EAChB,kBAAA,GAAqB,IAAA,aAAiB,iBAAA;AAAA;;;;;;ADTxC;iBEIgB,YAAA,IAAgB,qBAAqB;;;UCJpC,wBAAA;EACf,UAAA;EACA,eAAe;AAAA;;;;iBAMD,iBAAA,CAAkB,OAAA,EAAS,wBAAA,GAA2B,qBAAqB;;;KCZtF,UAAA,GAAa,eAAA,GAAkB,eAAA,GAAkB,YAAA;;;AJItD;iBIOgB,aAAA,CAAc,KAAiB,EAAV,UAAU;;;;iBAO/B,aAAA,CAAc,KAAiB,EAAV,UAAU;;;;iBAO/B,UAAA,CAAW,KAAiB,EAAV,UAAU;AJlBjB;AAO3B;;AAP2B,iBIyBX,QAAA,CAAS,KAAiB,EAAV,UAAU"}

package/dist/index.mjs

@@ -1,99 +1,138 @@
-import { createContext, useMemo, useState, useEffect, useContext } from 'react';
-import { RuntimeHQClient } from '@theruntimehq/js';
-import { jsx } from 'react/jsx-runtime';
+import React, { createContext, useCallback, useContext, useEffect, useMemo, useState } from "react";
+import { RuntimeHQClient } from "@theruntimehq/js";
+import { jsx } from "react/jsx-runtime";
 
-// src/context/index.ts
-var RuntimeHQContext = createContext(null);
+//#region src/context/index.ts
+const RuntimeHQContext = createContext(null);
+
+//#endregion
+//#region src/hooks/useRuntimeHQState.ts
+/**
+* A direct React hook to fetch and watch RuntimeHQ status without using a Context Provider.
+*/
 function useRuntimeHQState(options) {
-  const { runtimeKey, intervalSeconds = 15 } = options;
-  const [client, clientInitError] = useMemo(() => {
-    if (!runtimeKey) {
-      return [null, new Error("runtimeKey is required")];
-    }
-    try {
-      return [new RuntimeHQClient({ runtimeKey }), null];
-    } catch (err) {
-      return [null, err instanceof Error ? err : new Error(String(err))];
-    }
-  }, [runtimeKey]);
-  const [runtime, setRuntime] = useState(null);
-  const [error, setError] = useState(clientInitError || null);
-  const [loading, setLoading] = useState(!clientInitError);
-  useEffect(() => {
-    if (clientInitError) {
-      setError(clientInitError);
-      setLoading(false);
-      return;
-    }
-    if (!client) {
-      return;
-    }
-    setRuntime(null);
-    setError(null);
-    setLoading(true);
-    let active = true;
-    const unsubscribe = client.watchRuntime({
-      intervalSeconds,
-      onUpdate: (data) => {
-        if (active) {
-          setRuntime(data);
-          setError(null);
-          setLoading(false);
-        }
-      },
-      onError: (err) => {
-        if (active) {
-          setError(err);
-          setLoading(false);
-        }
-      }
-    });
-    return () => {
-      active = false;
-      unsubscribe();
-    };
-  }, [client, clientInitError, intervalSeconds]);
-  return {
-    runtime,
-    loading,
-    error
-  };
+	const { runtimeKey, intervalSeconds = 15 } = options;
+	const [client, clientInitError] = useMemo(() => {
+		if (!runtimeKey) return [null, /* @__PURE__ */ new Error("runtimeKey is required")];
+		try {
+			return [new RuntimeHQClient({ runtimeKey }), null];
+		} catch (err) {
+			return [null, err instanceof Error ? err : new Error(String(err))];
+		}
+	}, [runtimeKey]);
+	const [runtime, setRuntime] = useState(null);
+	const [error, setError] = useState(clientInitError || null);
+	const [loading, setLoading] = useState(!clientInitError);
+	useEffect(() => {
+		if (clientInitError) {
+			setError(clientInitError);
+			setLoading(false);
+			return;
+		}
+		if (!client) return;
+		setRuntime(null);
+		setError(null);
+		setLoading(true);
+		let active = true;
+		const unsubscribe = client.watchRuntime({
+			intervalSeconds,
+			onUpdate: (data) => {
+				if (active) {
+					setRuntime(data);
+					setError(null);
+					setLoading(false);
+				}
+			},
+			onError: (err) => {
+				if (active) {
+					setError(err);
+					setLoading(false);
+				}
+			}
+		});
+		return () => {
+			active = false;
+			unsubscribe();
+		};
+	}, [
+		client,
+		clientInitError,
+		intervalSeconds
+	]);
+	return {
+		runtime,
+		loading,
+		error,
+		hasCapability: useCallback((name) => {
+			return runtime ? runtime.hasCapability(name) : false;
+		}, [runtime]),
+		getCapabilityState: useCallback((name) => {
+			return runtime ? runtime.getCapabilityState(name) : void 0;
+		}, [runtime])
+	};
 }
-function RuntimeHQProvider({
-  runtimeKey,
-  intervalSeconds,
-  children
-}) {
-  const value = useRuntimeHQState({ runtimeKey, intervalSeconds });
-  return /* @__PURE__ */ jsx(RuntimeHQContext.Provider, { value, children });
+
+//#endregion
+//#region src/provider/index.tsx
+/**
+* Context Provider that manages a global RuntimeHQ client subscription and polling loop,
+* making the status state available to all child components using `useRuntimeHQ()`.
+*/
+function RuntimeHQProvider({ runtimeKey, intervalSeconds, children }) {
+	const value = useRuntimeHQState({
+		runtimeKey,
+		intervalSeconds
+	});
+	return /* @__PURE__ */ jsx(RuntimeHQContext.Provider, {
+		value,
+		children
+	});
 }
+
+//#endregion
+//#region src/hooks/useRuntimeHQ.ts
+/**
+* Accesses the global RuntimeHQ status check context.
+* Must be used within a `<RuntimeHQProvider>`.
+*/
 function useRuntimeHQ() {
-  const context = useContext(RuntimeHQContext);
-  if (!context) {
-    throw new Error("useRuntimeHQ must be used within a RuntimeHQProvider");
-  }
-  return context;
+	const context = useContext(RuntimeHQContext);
+	if (!context) throw new Error("useRuntimeHQ must be used within a RuntimeHQProvider");
+	return context;
 }
 
-// src/helpers/index.ts
-function getState(runtime) {
-  if (!runtime) return null;
-  if (typeof runtime === "string") return runtime;
-  return runtime.state || null;
+//#endregion
+//#region src/helpers/index.ts
+function getState(input) {
+	if (!input) return null;
+	if (typeof input === "string") return input;
+	return input.state || null;
 }
-function isOperational(runtime) {
-  return getState(runtime) === "OPERATIONAL";
+/**
+* Checks if the application runtime status is OPERATIONAL.
+*/
+function isOperational(input) {
+	return getState(input) === "OPERATIONAL";
 }
-function isMaintenance(runtime) {
-  return getState(runtime) === "MAINTENANCE";
+/**
+* Checks if the application runtime status is MAINTENANCE.
+*/
+function isMaintenance(input) {
+	return getState(input) === "MAINTENANCE";
 }
-function isDegraded(runtime) {
-  return getState(runtime) === "DEGRADED";
+/**
+* Checks if the application runtime status is DEGRADED.
+*/
+function isDegraded(input) {
+	return getState(input) === "DEGRADED";
 }
-function isOutage(runtime) {
-  return getState(runtime) === "OUTAGE";
+/**
+* Checks if the application runtime status is OUTAGE.
+*/
+function isOutage(input) {
+	return getState(input) === "OUTAGE";
 }
 
+//#endregion
 export { RuntimeHQProvider, isDegraded, isMaintenance, isOperational, isOutage, useRuntimeHQ, useRuntimeHQState };
-//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/context/index.ts","../src/hooks/useRuntimeHQState.ts","../src/provider/index.tsx","../src/hooks/useRuntimeHQ.ts","../src/helpers/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["\"use client\";\n\nimport { createContext } from \"react\";\nimport { RuntimeHQContextValue } from \"../types\";\n\nexport const RuntimeHQContext = createContext<RuntimeHQContextValue | null>(null);\n","\"use client\";\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport { RuntimeHQClient } from \"@theruntimehq/js\";\nimport { RuntimeResponse, RuntimeHQContextValue } from \"../types\";\n\nexport interface UseRuntimeHQStateOptions {\n  runtimeKey: string;\n  intervalSeconds?: number;\n}\n\n/**\n * A direct React hook to fetch and watch RuntimeHQ status without using a Context Provider.\n */\nexport function useRuntimeHQState(options: UseRuntimeHQStateOptions): RuntimeHQContextValue {\n  const { runtimeKey, intervalSeconds = 15 } = options;\n\n  // Safely instantiate RuntimeHQClient\n  const [client, clientInitError] = useMemo(() => {\n    if (!runtimeKey) {\n      return [null, new Error(\"runtimeKey is required\")] as const;\n    }\n    try {\n      return [new RuntimeHQClient({ runtimeKey }), null] as const;\n    } catch (err) {\n      return [null, err instanceof Error ? err : new Error(String(err))] as const;\n    }\n  }, [runtimeKey]);\n\n  const [runtime, setRuntime] = useState<RuntimeResponse | null>(null);\n  const [error, setError] = useState<Error | null>(clientInitError || null);\n  const [loading, setLoading] = useState<boolean>(!clientInitError);\n\n  useEffect(() => {\n    if (clientInitError) {\n      setError(clientInitError);\n      setLoading(false);\n      return;\n    }\n\n    if (!client) {\n      return;\n    }\n\n    // Reset states when the client or key changes\n    setRuntime(null);\n    setError(null);\n    setLoading(true);\n\n    let active = true;\n\n    const unsubscribe = client.watchRuntime({\n      intervalSeconds,\n      onUpdate: (data) => {\n        if (active) {\n          setRuntime(data);\n          setError(null);\n          setLoading(false);\n        }\n      },\n      onError: (err) => {\n        if (active) {\n          setError(err);\n          setLoading(false);\n        }\n      },\n    });\n\n    return () => {\n      active = false;\n      unsubscribe();\n    };\n  }, [client, clientInitError, intervalSeconds]);\n\n  return {\n    runtime,\n    loading,\n    error,\n  };\n}\n","\"use client\";\n\nimport React from \"react\";\nimport { RuntimeHQContext } from \"../context\";\nimport { useRuntimeHQState } from \"../hooks/useRuntimeHQState\";\n\nexport interface RuntimeHQProviderProps {\n  runtimeKey: string;\n  intervalSeconds?: number;\n  children: React.ReactNode;\n}\n\n/**\n * Context Provider that manages a global RuntimeHQ client subscription and polling loop,\n * making the status state available to all child components using `useRuntimeHQ()`.\n */\nexport function RuntimeHQProvider({\n  runtimeKey,\n  intervalSeconds,\n  children,\n}: RuntimeHQProviderProps) {\n  const value = useRuntimeHQState({ runtimeKey, intervalSeconds });\n\n  return (\n    <RuntimeHQContext.Provider value={value}>\n      {children}\n    </RuntimeHQContext.Provider>\n  );\n}\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport { RuntimeHQContext } from \"../context\";\nimport { RuntimeHQContextValue } from \"../types\";\n\n/**\n * Accesses the global RuntimeHQ status check context.\n * Must be used within a `<RuntimeHQProvider>`.\n */\nexport function useRuntimeHQ(): RuntimeHQContextValue {\n  const context = useContext(RuntimeHQContext);\n  if (!context) {\n    throw new Error(\"useRuntimeHQ must be used within a RuntimeHQProvider\");\n  }\n  return context;\n}\n","import { RuntimeResponse, RuntimeState } from \"../types\";\n\nfunction getState(runtime: RuntimeResponse | RuntimeState | null | undefined): RuntimeState | null {\n  if (!runtime) return null;\n  if (typeof runtime === \"string\") return runtime;\n  return runtime.state || null;\n}\n\n/**\n * Checks if the application runtime status is OPERATIONAL.\n */\nexport function isOperational(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean {\n  return getState(runtime) === \"OPERATIONAL\";\n}\n\n/**\n * Checks if the application runtime status is MAINTENANCE.\n */\nexport function isMaintenance(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean {\n  return getState(runtime) === \"MAINTENANCE\";\n}\n\n/**\n * Checks if the application runtime status is DEGRADED.\n */\nexport function isDegraded(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean {\n  return getState(runtime) === \"DEGRADED\";\n}\n\n/**\n * Checks if the application runtime status is OUTAGE.\n */\nexport function isOutage(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean {\n  return getState(runtime) === \"OUTAGE\";\n}\n"]}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/context/index.ts","../src/hooks/useRuntimeHQState.ts","../src/provider/index.tsx","../src/hooks/useRuntimeHQ.ts","../src/helpers/index.ts"],"sourcesContent":["\"use client\";\n\nimport { createContext } from \"react\";\nimport { RuntimeHQContextValue } from \"../types\";\n\nexport const RuntimeHQContext = createContext<RuntimeHQContextValue | null>(null);\n","\"use client\";\n\nimport { useState, useEffect, useMemo, useCallback } from \"react\";\nimport { RuntimeHQClient } from \"@theruntimehq/js\";\nimport { RuntimeResponse, RuntimeHQContextValue } from \"../types\";\n\nexport interface UseRuntimeHQStateOptions {\n  runtimeKey: string;\n  intervalSeconds?: number;\n}\n\n/**\n * A direct React hook to fetch and watch RuntimeHQ status without using a Context Provider.\n */\nexport function useRuntimeHQState(options: UseRuntimeHQStateOptions): RuntimeHQContextValue {\n  const { runtimeKey, intervalSeconds = 15 } = options;\n\n  // Safely instantiate RuntimeHQClient\n  const [client, clientInitError] = useMemo(() => {\n    if (!runtimeKey) {\n      return [null, new Error(\"runtimeKey is required\")] as const;\n    }\n    try {\n      return [new RuntimeHQClient({ runtimeKey }), null] as const;\n    } catch (err) {\n      return [null, err instanceof Error ? err : new Error(String(err))] as const;\n    }\n  }, [runtimeKey]);\n\n  const [runtime, setRuntime] = useState<RuntimeResponse | null>(null);\n  const [error, setError] = useState<Error | null>(clientInitError || null);\n  const [loading, setLoading] = useState<boolean>(!clientInitError);\n\n  useEffect(() => {\n    if (clientInitError) {\n      setError(clientInitError);\n      setLoading(false);\n      return;\n    }\n\n    if (!client) {\n      return;\n    }\n\n    // Reset states when the client or key changes\n    setRuntime(null);\n    setError(null);\n    setLoading(true);\n\n    let active = true;\n\n    const unsubscribe = client.watchRuntime({\n      intervalSeconds,\n      onUpdate: (data) => {\n        if (active) {\n          setRuntime(data);\n          setError(null);\n          setLoading(false);\n        }\n      },\n      onError: (err) => {\n        if (active) {\n          setError(err);\n          setLoading(false);\n        }\n      },\n    });\n\n    return () => {\n      active = false;\n      unsubscribe();\n    };\n  }, [client, clientInitError, intervalSeconds]);\n\n  const hasCapability = useCallback((name: string) => {\n    return runtime ? runtime.hasCapability(name) : false;\n  }, [runtime]);\n\n  const getCapabilityState = useCallback((name: string) => {\n    return runtime ? runtime.getCapabilityState(name) : undefined;\n  }, [runtime]);\n\n  return {\n    runtime,\n    loading,\n    error,\n    hasCapability,\n    getCapabilityState,\n  };\n}\n","\"use client\";\n\nimport React from \"react\";\nimport { RuntimeHQContext } from \"../context\";\nimport { useRuntimeHQState } from \"../hooks/useRuntimeHQState\";\n\nexport interface RuntimeHQProviderProps {\n  runtimeKey: string;\n  intervalSeconds?: number;\n  children: React.ReactNode;\n}\n\n/**\n * Context Provider that manages a global RuntimeHQ client subscription and polling loop,\n * making the status state available to all child components using `useRuntimeHQ()`.\n */\nexport function RuntimeHQProvider({\n  runtimeKey,\n  intervalSeconds,\n  children,\n}: RuntimeHQProviderProps) {\n  const value = useRuntimeHQState({ runtimeKey, intervalSeconds });\n\n  return (\n    <RuntimeHQContext.Provider value={value}>\n      {children}\n    </RuntimeHQContext.Provider>\n  );\n}\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport { RuntimeHQContext } from \"../context\";\nimport { RuntimeHQContextValue } from \"../types\";\n\n/**\n * Accesses the global RuntimeHQ status check context.\n * Must be used within a `<RuntimeHQProvider>`.\n */\nexport function useRuntimeHQ(): RuntimeHQContextValue {\n  const context = useContext(RuntimeHQContext);\n  if (!context) {\n    throw new Error(\"useRuntimeHQ must be used within a RuntimeHQProvider\");\n  }\n  return context;\n}\n","import { RuntimeResponse, RuntimeState, CapabilityState } from \"../types\";\n\ntype StateInput = RuntimeResponse | CapabilityState | RuntimeState | null | undefined;\n\nfunction getState(input: StateInput): RuntimeState | null {\n  if (!input) return null;\n  if (typeof input === \"string\") return input;\n  return input.state || null;\n}\n\n/**\n * Checks if the application runtime status is OPERATIONAL.\n */\nexport function isOperational(input: StateInput): boolean {\n  return getState(input) === \"OPERATIONAL\";\n}\n\n/**\n * Checks if the application runtime status is MAINTENANCE.\n */\nexport function isMaintenance(input: StateInput): boolean {\n  return getState(input) === \"MAINTENANCE\";\n}\n\n/**\n * Checks if the application runtime status is DEGRADED.\n */\nexport function isDegraded(input: StateInput): boolean {\n  return getState(input) === \"DEGRADED\";\n}\n\n/**\n * Checks if the application runtime status is OUTAGE.\n */\nexport function isOutage(input: StateInput): boolean {\n  return getState(input) === \"OUTAGE\";\n}\n"],"mappings":";;;;;AAKA,MAAa,mBAAmB,cAA4C,IAAI;;;;;;;ACShF,SAAgB,kBAAkB,SAA0D;CAC1F,MAAM,EAAE,YAAY,kBAAkB,OAAO;CAG7C,MAAM,CAAC,QAAQ,mBAAmB,cAAc;EAC9C,IAAI,CAAC,YACH,OAAO,CAAC,sBAAM,IAAI,MAAM,wBAAwB,CAAC;EAEnD,IAAI;GACF,OAAO,CAAC,IAAI,gBAAgB,EAAE,WAAW,CAAC,GAAG,IAAI;EACnD,SAAS,KAAK;GACZ,OAAO,CAAC,MAAM,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;EACnE;CACF,GAAG,CAAC,UAAU,CAAC;CAEf,MAAM,CAAC,SAAS,cAAc,SAAiC,IAAI;CACnE,MAAM,CAAC,OAAO,YAAY,SAAuB,mBAAmB,IAAI;CACxE,MAAM,CAAC,SAAS,cAAc,SAAkB,CAAC,eAAe;CAEhE,gBAAgB;EACd,IAAI,iBAAiB;GACnB,SAAS,eAAe;GACxB,WAAW,KAAK;GAChB;EACF;EAEA,IAAI,CAAC,QACH;EAIF,WAAW,IAAI;EACf,SAAS,IAAI;EACb,WAAW,IAAI;EAEf,IAAI,SAAS;EAEb,MAAM,cAAc,OAAO,aAAa;GACtC;GACA,WAAW,SAAS;IAClB,IAAI,QAAQ;KACV,WAAW,IAAI;KACf,SAAS,IAAI;KACb,WAAW,KAAK;IAClB;GACF;GACA,UAAU,QAAQ;IAChB,IAAI,QAAQ;KACV,SAAS,GAAG;KACZ,WAAW,KAAK;IAClB;GACF;EACF,CAAC;EAED,aAAa;GACX,SAAS;GACT,YAAY;EACd;CACF,GAAG;EAAC;EAAQ;EAAiB;CAAe,CAAC;CAU7C,OAAO;EACL;EACA;EACA;EACA,eAZoB,aAAa,SAAiB;GAClD,OAAO,UAAU,QAAQ,cAAc,IAAI,IAAI;EACjD,GAAG,CAAC,OAAO,CAUG;EACZ,oBATyB,aAAa,SAAiB;GACvD,OAAO,UAAU,QAAQ,mBAAmB,IAAI,IAAI;EACtD,GAAG,CAAC,OAAO,CAOQ;CACnB;AACF;;;;;;;;ACzEA,SAAgB,kBAAkB,EAChC,YACA,iBACA,YACyB;CACzB,MAAM,QAAQ,kBAAkB;EAAE;EAAY;CAAgB,CAAC;CAE/D,OACE,oBAAC,iBAAiB,UAAlB;EAAkC;EAC/B;CACwB;AAE/B;;;;;;;;AClBA,SAAgB,eAAsC;CACpD,MAAM,UAAU,WAAW,gBAAgB;CAC3C,IAAI,CAAC,SACH,MAAM,IAAI,MAAM,sDAAsD;CAExE,OAAO;AACT;;;;ACZA,SAAS,SAAS,OAAwC;CACxD,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,OAAO,MAAM,SAAS;AACxB;;;;AAKA,SAAgB,cAAc,OAA4B;CACxD,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;AAKA,SAAgB,cAAc,OAA4B;CACxD,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;AAKA,SAAgB,WAAW,OAA4B;CACrD,OAAO,SAAS,KAAK,MAAM;AAC7B;;;;AAKA,SAAgB,SAAS,OAA4B;CACnD,OAAO,SAAS,KAAK,MAAM;AAC7B"}

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@theruntimehq/react",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "Official React SDK for RuntimeHQ status checking and monitoring.",
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/index.d.cts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
+      "types": {
+        "import": "./dist/index.d.mts",
+        "require": "./dist/index.d.cts"
+      },
+      "require": "./dist/index.cjs",
       "import": "./dist/index.mjs"
     }
   },
@@ -16,7 +19,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsdown",
     "test": "vitest run",
     "prepublishOnly": "npm run build",
     "postversion": "git push && git push --tags"
@@ -40,7 +43,7 @@
     "react-dom": ">=18.0.0"
   },
   "dependencies": {
-    "@theruntimehq/js": "^0.1.4"
+    "@theruntimehq/js": "^0.2.1"
   },
   "devDependencies": {
     "@testing-library/react": "^15.0.7",
@@ -49,8 +52,8 @@
     "jsdom": "^24.0.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "tsup": "^8.0.2",
+    "tsdown": "^0.22.3",
     "typescript": "^5.4.5",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.9"
   }
 }

package/dist/index.d.ts

@@ -1,54 +0,0 @@
-import React from 'react';
-import { RuntimeResponse, RuntimeState } from '@theruntimehq/js';
-export { RuntimeHQClientOptions, RuntimeResponse, RuntimeSourceType, RuntimeState, WatchRuntimeOptions } from '@theruntimehq/js';
-
-interface RuntimeHQProviderProps {
-    runtimeKey: string;
-    intervalSeconds?: number;
-    children: React.ReactNode;
-}
-/**
- * Context Provider that manages a global RuntimeHQ client subscription and polling loop,
- * making the status state available to all child components using `useRuntimeHQ()`.
- */
-declare function RuntimeHQProvider({ runtimeKey, intervalSeconds, children, }: RuntimeHQProviderProps): React.JSX.Element;
-
-interface RuntimeHQContextValue {
-    runtime: RuntimeResponse | null;
-    loading: boolean;
-    error: Error | null;
-}
-
-/**
- * Accesses the global RuntimeHQ status check context.
- * Must be used within a `<RuntimeHQProvider>`.
- */
-declare function useRuntimeHQ(): RuntimeHQContextValue;
-
-interface UseRuntimeHQStateOptions {
-    runtimeKey: string;
-    intervalSeconds?: number;
-}
-/**
- * A direct React hook to fetch and watch RuntimeHQ status without using a Context Provider.
- */
-declare function useRuntimeHQState(options: UseRuntimeHQStateOptions): RuntimeHQContextValue;
-
-/**
- * Checks if the application runtime status is OPERATIONAL.
- */
-declare function isOperational(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean;
-/**
- * Checks if the application runtime status is MAINTENANCE.
- */
-declare function isMaintenance(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean;
-/**
- * Checks if the application runtime status is DEGRADED.
- */
-declare function isDegraded(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean;
-/**
- * Checks if the application runtime status is OUTAGE.
- */
-declare function isOutage(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean;
-
-export { type RuntimeHQContextValue, RuntimeHQProvider, type RuntimeHQProviderProps, type UseRuntimeHQStateOptions, isDegraded, isMaintenance, isOperational, isOutage, useRuntimeHQ, useRuntimeHQState };

package/dist/index.js

@@ -1,107 +0,0 @@
-'use strict';
-
-var react = require('react');
-var js = require('@theruntimehq/js');
-var jsxRuntime = require('react/jsx-runtime');
-
-// src/context/index.ts
-var RuntimeHQContext = react.createContext(null);
-function useRuntimeHQState(options) {
-  const { runtimeKey, intervalSeconds = 15 } = options;
-  const [client, clientInitError] = react.useMemo(() => {
-    if (!runtimeKey) {
-      return [null, new Error("runtimeKey is required")];
-    }
-    try {
-      return [new js.RuntimeHQClient({ runtimeKey }), null];
-    } catch (err) {
-      return [null, err instanceof Error ? err : new Error(String(err))];
-    }
-  }, [runtimeKey]);
-  const [runtime, setRuntime] = react.useState(null);
-  const [error, setError] = react.useState(clientInitError || null);
-  const [loading, setLoading] = react.useState(!clientInitError);
-  react.useEffect(() => {
-    if (clientInitError) {
-      setError(clientInitError);
-      setLoading(false);
-      return;
-    }
-    if (!client) {
-      return;
-    }
-    setRuntime(null);
-    setError(null);
-    setLoading(true);
-    let active = true;
-    const unsubscribe = client.watchRuntime({
-      intervalSeconds,
-      onUpdate: (data) => {
-        if (active) {
-          setRuntime(data);
-          setError(null);
-          setLoading(false);
-        }
-      },
-      onError: (err) => {
-        if (active) {
-          setError(err);
-          setLoading(false);
-        }
-      }
-    });
-    return () => {
-      active = false;
-      unsubscribe();
-    };
-  }, [client, clientInitError, intervalSeconds]);
-  return {
-    runtime,
-    loading,
-    error
-  };
-}
-function RuntimeHQProvider({
-  runtimeKey,
-  intervalSeconds,
-  children
-}) {
-  const value = useRuntimeHQState({ runtimeKey, intervalSeconds });
-  return /* @__PURE__ */ jsxRuntime.jsx(RuntimeHQContext.Provider, { value, children });
-}
-function useRuntimeHQ() {
-  const context = react.useContext(RuntimeHQContext);
-  if (!context) {
-    throw new Error("useRuntimeHQ must be used within a RuntimeHQProvider");
-  }
-  return context;
-}
-
-// src/helpers/index.ts
-function getState(runtime) {
-  if (!runtime) return null;
-  if (typeof runtime === "string") return runtime;
-  return runtime.state || null;
-}
-function isOperational(runtime) {
-  return getState(runtime) === "OPERATIONAL";
-}
-function isMaintenance(runtime) {
-  return getState(runtime) === "MAINTENANCE";
-}
-function isDegraded(runtime) {
-  return getState(runtime) === "DEGRADED";
-}
-function isOutage(runtime) {
-  return getState(runtime) === "OUTAGE";
-}
-
-exports.RuntimeHQProvider = RuntimeHQProvider;
-exports.isDegraded = isDegraded;
-exports.isMaintenance = isMaintenance;
-exports.isOperational = isOperational;
-exports.isOutage = isOutage;
-exports.useRuntimeHQ = useRuntimeHQ;
-exports.useRuntimeHQState = useRuntimeHQState;
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/context/index.ts","../src/hooks/useRuntimeHQState.ts","../src/provider/index.tsx","../src/hooks/useRuntimeHQ.ts","../src/helpers/index.ts"],"names":["createContext","useMemo","RuntimeHQClient","useState","useEffect","jsx","useContext"],"mappings":"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","file":"index.js","sourcesContent":["\"use client\";\n\nimport { createContext } from \"react\";\nimport { RuntimeHQContextValue } from \"../types\";\n\nexport const RuntimeHQContext = createContext<RuntimeHQContextValue | null>(null);\n","\"use client\";\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport { RuntimeHQClient } from \"@theruntimehq/js\";\nimport { RuntimeResponse, RuntimeHQContextValue } from \"../types\";\n\nexport interface UseRuntimeHQStateOptions {\n  runtimeKey: string;\n  intervalSeconds?: number;\n}\n\n/**\n * A direct React hook to fetch and watch RuntimeHQ status without using a Context Provider.\n */\nexport function useRuntimeHQState(options: UseRuntimeHQStateOptions): RuntimeHQContextValue {\n  const { runtimeKey, intervalSeconds = 15 } = options;\n\n  // Safely instantiate RuntimeHQClient\n  const [client, clientInitError] = useMemo(() => {\n    if (!runtimeKey) {\n      return [null, new Error(\"runtimeKey is required\")] as const;\n    }\n    try {\n      return [new RuntimeHQClient({ runtimeKey }), null] as const;\n    } catch (err) {\n      return [null, err instanceof Error ? err : new Error(String(err))] as const;\n    }\n  }, [runtimeKey]);\n\n  const [runtime, setRuntime] = useState<RuntimeResponse | null>(null);\n  const [error, setError] = useState<Error | null>(clientInitError || null);\n  const [loading, setLoading] = useState<boolean>(!clientInitError);\n\n  useEffect(() => {\n    if (clientInitError) {\n      setError(clientInitError);\n      setLoading(false);\n      return;\n    }\n\n    if (!client) {\n      return;\n    }\n\n    // Reset states when the client or key changes\n    setRuntime(null);\n    setError(null);\n    setLoading(true);\n\n    let active = true;\n\n    const unsubscribe = client.watchRuntime({\n      intervalSeconds,\n      onUpdate: (data) => {\n        if (active) {\n          setRuntime(data);\n          setError(null);\n          setLoading(false);\n        }\n      },\n      onError: (err) => {\n        if (active) {\n          setError(err);\n          setLoading(false);\n        }\n      },\n    });\n\n    return () => {\n      active = false;\n      unsubscribe();\n    };\n  }, [client, clientInitError, intervalSeconds]);\n\n  return {\n    runtime,\n    loading,\n    error,\n  };\n}\n","\"use client\";\n\nimport React from \"react\";\nimport { RuntimeHQContext } from \"../context\";\nimport { useRuntimeHQState } from \"../hooks/useRuntimeHQState\";\n\nexport interface RuntimeHQProviderProps {\n  runtimeKey: string;\n  intervalSeconds?: number;\n  children: React.ReactNode;\n}\n\n/**\n * Context Provider that manages a global RuntimeHQ client subscription and polling loop,\n * making the status state available to all child components using `useRuntimeHQ()`.\n */\nexport function RuntimeHQProvider({\n  runtimeKey,\n  intervalSeconds,\n  children,\n}: RuntimeHQProviderProps) {\n  const value = useRuntimeHQState({ runtimeKey, intervalSeconds });\n\n  return (\n    <RuntimeHQContext.Provider value={value}>\n      {children}\n    </RuntimeHQContext.Provider>\n  );\n}\n","\"use client\";\n\nimport { useContext } from \"react\";\nimport { RuntimeHQContext } from \"../context\";\nimport { RuntimeHQContextValue } from \"../types\";\n\n/**\n * Accesses the global RuntimeHQ status check context.\n * Must be used within a `<RuntimeHQProvider>`.\n */\nexport function useRuntimeHQ(): RuntimeHQContextValue {\n  const context = useContext(RuntimeHQContext);\n  if (!context) {\n    throw new Error(\"useRuntimeHQ must be used within a RuntimeHQProvider\");\n  }\n  return context;\n}\n","import { RuntimeResponse, RuntimeState } from \"../types\";\n\nfunction getState(runtime: RuntimeResponse | RuntimeState | null | undefined): RuntimeState | null {\n  if (!runtime) return null;\n  if (typeof runtime === \"string\") return runtime;\n  return runtime.state || null;\n}\n\n/**\n * Checks if the application runtime status is OPERATIONAL.\n */\nexport function isOperational(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean {\n  return getState(runtime) === \"OPERATIONAL\";\n}\n\n/**\n * Checks if the application runtime status is MAINTENANCE.\n */\nexport function isMaintenance(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean {\n  return getState(runtime) === \"MAINTENANCE\";\n}\n\n/**\n * Checks if the application runtime status is DEGRADED.\n */\nexport function isDegraded(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean {\n  return getState(runtime) === \"DEGRADED\";\n}\n\n/**\n * Checks if the application runtime status is OUTAGE.\n */\nexport function isOutage(runtime: RuntimeResponse | RuntimeState | null | undefined): boolean {\n  return getState(runtime) === \"OUTAGE\";\n}\n"]}