@d13co/algo-metrics-react 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# @d13co/algo-metrics-react
+
+[![npm version](https://img.shields.io/npm/v/@d13co/algo-metrics-react)](https://www.npmjs.com/package/@d13co/algo-metrics-react)
+
+React hooks for [@d13co/algo-metrics-sdk](https://www.npmjs.com/package/@d13co/algo-metrics-sdk). Wraps the SDK with a single shared watcher callback so multiple components can consume live Algorand block metrics without duplicate network calls.
+
+## Installation
+
+```bash
+pnpm add @d13co/algo-metrics-react @d13co/algo-metrics-sdk
+```
+
+React 18 or 19 is required as a peer dependency.
+
+## Quick Start
+
+Wrap your app with `AlgoMetricsProvider`, then use hooks anywhere inside:
+
+```tsx
+import { AlgoMetricsProvider, useLatestRound, useTransactionsPerSecond } from '@d13co/algo-metrics-react';
+
+function App() {
+  return (
+    <AlgoMetricsProvider>
+      <Dashboard />
+    </AlgoMetricsProvider>
+  );
+}
+
+function Dashboard() {
+  const round = useLatestRound();
+  const tps = useTransactionsPerSecond();
+
+  return (
+    <div>
+      <p>Latest round: {round?.toString() ?? '–'}</p>
+      <p>TPS: {tps?.toFixed(1) ?? '–'}</p>
+    </div>
+  );
+}
+```
+
+## Provider
+
+### `<AlgoMetricsProvider>`
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `options` | `AlgoMetricsSDKOptions` | `{}` | Options forwarded to `new AlgoMetricsSDK(options)` |
+| `sdk` | `AlgoMetricsSDK` | — | Use an existing SDK instance instead of creating one |
+| `children` | `ReactNode` | — | — |
+
+The provider registers a single watcher callback on mount and unregisters on unmount. It auto-detects whether the connected network is mainnet by comparing the genesis hash from `algod.getTransactionParams()`. All hooks derive their values from the shared block data via context.
+
+## Hooks
+
+### `useLatestRound(): bigint | null`
+
+Returns the most recent block round number, or `null` while loading.
+
+### `useAverageRoundTime(): number | null`
+
+Returns the average time between blocks in seconds, computed as `(last.ts - first.ts) / (blockCount - 1)`.
+
+### `useTransactionsPerSecond(): number | null`
+
+Returns the current transactions per second, computed as `(last.tc - first.tc) / (last.ts - first.ts)`.
+
+### `useTransactionCount(): bigint | null`
+
+Returns the cumulative transaction count. Adds `563,279` on mainnet to account for the genesis offset.
+
+### `useBlockData(): BlockRoundTimeAndTc[] | null`
+
+Returns the raw block data array from the provider.
+
+### `useAlgoMetricsContext(): AlgoMetricsContextValue`
+
+Returns the full context value: `{ data, isLoading, sdk, isMainnet }`.
+
+## Pure Functions
+
+The compute functions are also exported for use outside of React:
+
+```ts
+import { getLatestRound, getAverageRoundTime, getTransactionsPerSecond, getTransactionCount, MAINNET_TC_OFFSET } from '@d13co/algo-metrics-react';
+```
+
+## Custom Algorand Client
+
+```tsx
+import { AlgorandClient } from '@algorandfoundation/algokit-utils';
+
+<AlgoMetricsProvider options={{ algorand: AlgorandClient.testNet() }}>
+  {children}
+</AlgoMetricsProvider>
+```
+
+## License
+
+MIT

package/dist/__tests__/compute.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compute.test.d.ts.map

package/dist/__tests__/compute.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/compute.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/compute.test.js

@@ -0,0 +1,76 @@
+import { describe, it, expect } from 'vitest';
+import { getLatestRound, getAverageRoundTime, getTransactionsPerSecond, getTransactionCount, isMainnetGenesisHash, MAINNET_TC_OFFSET, MAINNET_GENESIS_HASH, } from '../compute.js';
+function block(rnd, ts = rnd, tc = rnd * 10) {
+    return { rnd: BigInt(rnd), ts, tc: BigInt(tc) };
+}
+describe('getLatestRound', () => {
+    it('returns null for empty data', () => {
+        expect(getLatestRound([])).toBeNull();
+    });
+    it('returns the last round number', () => {
+        expect(getLatestRound([block(1), block(2), block(3)])).toBe(3n);
+    });
+});
+describe('getAverageRoundTime', () => {
+    it('returns null for fewer than 2 blocks', () => {
+        expect(getAverageRoundTime([])).toBeNull();
+        expect(getAverageRoundTime([block(1)])).toBeNull();
+    });
+    it('computes (last.ts - first.ts) / (length - 1)', () => {
+        const data = [block(1, 100), block(2, 103), block(3, 106)];
+        expect(getAverageRoundTime(data)).toBe(3);
+    });
+    it('handles non-uniform timestamps', () => {
+        const data = [block(1, 0), block(2, 2), block(3, 10)];
+        expect(getAverageRoundTime(data)).toBe(5);
+    });
+});
+describe('getTransactionsPerSecond', () => {
+    it('returns null for fewer than 2 blocks', () => {
+        expect(getTransactionsPerSecond([])).toBeNull();
+        expect(getTransactionsPerSecond([block(1)])).toBeNull();
+    });
+    it('returns null when time diff is zero', () => {
+        const data = [block(1, 100, 10), block(2, 100, 20)];
+        expect(getTransactionsPerSecond(data)).toBeNull();
+    });
+    it('computes (last.tc - first.tc) / (last.ts - first.ts)', () => {
+        const data = [block(1, 0, 0), block(2, 10, 100)];
+        expect(getTransactionsPerSecond(data)).toBe(10);
+    });
+});
+describe('getTransactionCount', () => {
+    it('returns null for empty data', () => {
+        expect(getTransactionCount([], true)).toBeNull();
+    });
+    it('returns last tc for non-mainnet', () => {
+        expect(getTransactionCount([block(1, 1, 500)], false)).toBe(500n);
+    });
+    it('adds MAINNET_TC_OFFSET for mainnet', () => {
+        expect(getTransactionCount([block(1, 1, 500)], true)).toBe(500n + MAINNET_TC_OFFSET);
+    });
+});
+describe('MAINNET_TC_OFFSET', () => {
+    it('equals 563_279n', () => {
+        expect(MAINNET_TC_OFFSET).toBe(563279n);
+    });
+});
+describe('isMainnetGenesisHash', () => {
+    function b64ToUint8Array(b64) {
+        const binary = atob(b64);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return bytes;
+    }
+    it('returns true for mainnet genesis hash', () => {
+        const hash = b64ToUint8Array(MAINNET_GENESIS_HASH);
+        expect(isMainnetGenesisHash(hash)).toBe(true);
+    });
+    it('returns false for a different genesis hash', () => {
+        const hash = b64ToUint8Array('SGO1GKSzyE7IEPItTxCByw9x8FmnrCDexi9/cOUJOiI=');
+        expect(isMainnetGenesisHash(hash)).toBe(false);
+    });
+});
+//# sourceMappingURL=compute.test.js.map

package/dist/__tests__/compute.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.test.js","sourceRoot":"","sources":["../../src/__tests__/compute.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/hooks.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hooks.test.d.ts.map

package/dist/__tests__/hooks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hooks.test.tsx"],"names":[],"mappings":""}

package/dist/__tests__/hooks.test.js

@@ -0,0 +1,210 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { renderHook, act } from '@testing-library/react';
+import { AlgoMetricsProvider } from '../context.js';
+import { useLatestRound, useAverageRoundTime, useTransactionsPerSecond, useTransactionCount, useBlockData, useAlgoMetricsContext, } from '../index.js';
+import { MAINNET_TC_OFFSET, MAINNET_GENESIS_HASH } from '../compute.js';
+const TESTNET_GENESIS_HASH = 'SGO1GKSzyE7IEPItTxCByw9x8FmnrCDexi9/cOUJOiI=';
+function b64ToUint8Array(b64) {
+    const binary = atob(b64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+function block(rnd, ts = rnd, tc = rnd * 10) {
+    return { rnd: BigInt(rnd), ts, tc: BigInt(tc) };
+}
+const testBlocks = [block(1, 100, 1000), block(2, 103, 1050), block(3, 106, 1100)];
+function createMockSDK(genesisHashB64 = MAINNET_GENESIS_HASH) {
+    let capturedCallback = null;
+    const mock = {
+        registerTsTcWatcher: vi.fn(async (cb) => {
+            capturedCallback = cb;
+        }),
+        unregisterTsTcWatcher: vi.fn(),
+        algorand: {
+            client: {
+                algod: {
+                    getTransactionParams: vi.fn(() => ({
+                        do: vi.fn(async () => ({
+                            genesisHash: b64ToUint8Array(genesisHashB64),
+                        })),
+                    })),
+                },
+            },
+        },
+    };
+    return {
+        sdk: mock,
+        mock,
+        emitBlocks: (blocks) => {
+            act(() => {
+                capturedCallback?.(blocks);
+            });
+        },
+    };
+}
+function createWrapper(sdk) {
+    return function Wrapper({ children }) {
+        return _jsx(AlgoMetricsProvider, { sdk: sdk, children: children });
+    };
+}
+describe('AlgoMetricsProvider', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('registers watcher on mount and unregisters on unmount', () => {
+        const { sdk, mock } = createMockSDK();
+        const { unmount } = renderHook(() => useAlgoMetricsContext(), {
+            wrapper: createWrapper(sdk),
+        });
+        expect(mock.registerTsTcWatcher).toHaveBeenCalledOnce();
+        unmount();
+        expect(mock.unregisterTsTcWatcher).toHaveBeenCalledOnce();
+    });
+    it('starts in loading state with null data', () => {
+        const { sdk } = createMockSDK();
+        const { result } = renderHook(() => useAlgoMetricsContext(), {
+            wrapper: createWrapper(sdk),
+        });
+        expect(result.current.isLoading).toBe(true);
+        expect(result.current.data).toBeNull();
+    });
+    it('updates data when callback fires', () => {
+        const { sdk, emitBlocks } = createMockSDK();
+        const { result } = renderHook(() => useAlgoMetricsContext(), {
+            wrapper: createWrapper(sdk),
+        });
+        emitBlocks(testBlocks);
+        expect(result.current.isLoading).toBe(false);
+        expect(result.current.data).toEqual(testBlocks);
+    });
+    it('auto-detects mainnet from genesis hash', async () => {
+        const { sdk, emitBlocks } = createMockSDK(MAINNET_GENESIS_HASH);
+        const { result } = renderHook(() => useAlgoMetricsContext(), {
+            wrapper: createWrapper(sdk),
+        });
+        emitBlocks(testBlocks);
+        await vi.waitFor(() => {
+            expect(result.current.isMainnet).toBe(true);
+        });
+    });
+    it('auto-detects non-mainnet from genesis hash', async () => {
+        const { sdk, emitBlocks } = createMockSDK(TESTNET_GENESIS_HASH);
+        const { result } = renderHook(() => useAlgoMetricsContext(), {
+            wrapper: createWrapper(sdk),
+        });
+        emitBlocks(testBlocks);
+        await vi.waitFor(() => {
+            expect(result.current.isMainnet).toBe(false);
+        });
+    });
+});
+describe('useLatestRound', () => {
+    it('returns null before data arrives', () => {
+        const { sdk } = createMockSDK();
+        const { result } = renderHook(() => useLatestRound(), {
+            wrapper: createWrapper(sdk),
+        });
+        expect(result.current).toBeNull();
+    });
+    it('returns the latest round', () => {
+        const { sdk, emitBlocks } = createMockSDK();
+        const { result } = renderHook(() => useLatestRound(), {
+            wrapper: createWrapper(sdk),
+        });
+        emitBlocks(testBlocks);
+        expect(result.current).toBe(3n);
+    });
+});
+describe('useAverageRoundTime', () => {
+    it('returns null before data arrives', () => {
+        const { sdk } = createMockSDK();
+        const { result } = renderHook(() => useAverageRoundTime(), {
+            wrapper: createWrapper(sdk),
+        });
+        expect(result.current).toBeNull();
+    });
+    it('computes average round time', () => {
+        const { sdk, emitBlocks } = createMockSDK();
+        const { result } = renderHook(() => useAverageRoundTime(), {
+            wrapper: createWrapper(sdk),
+        });
+        emitBlocks(testBlocks);
+        expect(result.current).toBe(3);
+    });
+});
+describe('useTransactionsPerSecond', () => {
+    it('returns null before data arrives', () => {
+        const { sdk } = createMockSDK();
+        const { result } = renderHook(() => useTransactionsPerSecond(), {
+            wrapper: createWrapper(sdk),
+        });
+        expect(result.current).toBeNull();
+    });
+    it('computes TPS', () => {
+        const { sdk, emitBlocks } = createMockSDK();
+        const { result } = renderHook(() => useTransactionsPerSecond(), {
+            wrapper: createWrapper(sdk),
+        });
+        // tc diff = 1100 - 1000 = 100, ts diff = 106 - 100 = 6
+        emitBlocks(testBlocks);
+        expect(result.current).toBeCloseTo(100 / 6);
+    });
+});
+describe('useTransactionCount', () => {
+    it('returns null before data arrives', () => {
+        const { sdk } = createMockSDK();
+        const { result } = renderHook(() => useTransactionCount(), {
+            wrapper: createWrapper(sdk),
+        });
+        expect(result.current).toBeNull();
+    });
+    it('applies mainnet offset when connected to mainnet', async () => {
+        const { sdk, emitBlocks } = createMockSDK(MAINNET_GENESIS_HASH);
+        const { result } = renderHook(() => useTransactionCount(), {
+            wrapper: createWrapper(sdk),
+        });
+        emitBlocks(testBlocks);
+        await vi.waitFor(() => {
+            expect(result.current).toBe(1100n + MAINNET_TC_OFFSET);
+        });
+    });
+    it('does not apply offset when connected to testnet', async () => {
+        const { sdk, emitBlocks } = createMockSDK(TESTNET_GENESIS_HASH);
+        const { result } = renderHook(() => useTransactionCount(), {
+            wrapper: createWrapper(sdk),
+        });
+        emitBlocks(testBlocks);
+        await vi.waitFor(() => {
+            expect(result.current).toBe(1100n);
+        });
+    });
+});
+describe('useBlockData', () => {
+    it('returns null before data arrives', () => {
+        const { sdk } = createMockSDK();
+        const { result } = renderHook(() => useBlockData(), {
+            wrapper: createWrapper(sdk),
+        });
+        expect(result.current).toBeNull();
+    });
+    it('returns raw block data', () => {
+        const { sdk, emitBlocks } = createMockSDK();
+        const { result } = renderHook(() => useBlockData(), {
+            wrapper: createWrapper(sdk),
+        });
+        emitBlocks(testBlocks);
+        expect(result.current).toEqual(testBlocks);
+    });
+});
+describe('useAlgoMetricsContext', () => {
+    it('throws when used outside provider', () => {
+        expect(() => {
+            renderHook(() => useAlgoMetricsContext());
+        }).toThrow('useAlgoMetricsContext must be used within an AlgoMetricsProvider');
+    });
+});
+//# sourceMappingURL=hooks.test.js.map

package/dist/__tests__/hooks.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.test.js","sourceRoot":"","sources":["../../src/__tests__/hooks.test.tsx"],"names":[],"mappings":"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"}

package/dist/compute.d.ts

@@ -0,0 +1,9 @@
+import type { BlockRoundTimeAndTc } from '@d13co/algo-metrics-sdk';
+export declare const MAINNET_TC_OFFSET = 563279n;
+export declare const MAINNET_GENESIS_HASH = "wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=";
+export declare function isMainnetGenesisHash(genesisHash: Uint8Array): boolean;
+export declare function getLatestRound(data: BlockRoundTimeAndTc[]): bigint | null;
+export declare function getAverageRoundTime(data: BlockRoundTimeAndTc[]): number | null;
+export declare function getTransactionsPerSecond(data: BlockRoundTimeAndTc[]): number | null;
+export declare function getTransactionCount(data: BlockRoundTimeAndTc[], isMainnet: boolean): bigint | null;
+//# sourceMappingURL=compute.d.ts.map

package/dist/compute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.d.ts","sourceRoot":"","sources":["../src/compute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,eAAO,MAAM,iBAAiB,UAAW,CAAC;AAE1C,eAAO,MAAM,oBAAoB,iDAAiD,CAAC;AAEnF,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAGrE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,MAAM,GAAG,IAAI,CAGzE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,MAAM,GAAG,IAAI,CAK9E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,MAAM,GAAG,IAAI,CAOnF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,mBAAmB,EAAE,EAC3B,SAAS,EAAE,OAAO,GACjB,MAAM,GAAG,IAAI,CAIf"}

package/dist/compute.js

@@ -0,0 +1,35 @@
+export const MAINNET_TC_OFFSET = 563279n;
+export const MAINNET_GENESIS_HASH = 'wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=';
+export function isMainnetGenesisHash(genesisHash) {
+    const b64 = btoa(String.fromCharCode(...genesisHash));
+    return b64 === MAINNET_GENESIS_HASH;
+}
+export function getLatestRound(data) {
+    if (data.length === 0)
+        return null;
+    return data[data.length - 1].rnd;
+}
+export function getAverageRoundTime(data) {
+    if (data.length < 2)
+        return null;
+    const first = data[0];
+    const last = data[data.length - 1];
+    return (last.ts - first.ts) / (data.length - 1);
+}
+export function getTransactionsPerSecond(data) {
+    if (data.length < 2)
+        return null;
+    const first = data[0];
+    const last = data[data.length - 1];
+    const timeDiff = last.ts - first.ts;
+    if (timeDiff === 0)
+        return null;
+    return Number(last.tc - first.tc) / timeDiff;
+}
+export function getTransactionCount(data, isMainnet) {
+    if (data.length === 0)
+        return null;
+    const lastTc = data[data.length - 1].tc;
+    return isMainnet ? lastTc + MAINNET_TC_OFFSET : lastTc;
+}
+//# sourceMappingURL=compute.js.map

package/dist/compute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.js","sourceRoot":"","sources":["../src/compute.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAQ,CAAC;AAE1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,8CAA8C,CAAC;AAEnF,MAAM,UAAU,oBAAoB,CAAC,WAAuB;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IACtD,OAAO,GAAG,KAAK,oBAAoB,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAA2B;IACxD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAA2B;IAC7D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAA2B;IAClE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;IACpC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAA2B,EAC3B,SAAkB;IAElB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,EAAE,CAAC;IACzC,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC;AACzD,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,4 @@
+import type { AlgoMetricsContextValue, AlgoMetricsProviderProps } from './types.js';
+export declare function AlgoMetricsProvider({ options, sdk: externalSdk, children, }: AlgoMetricsProviderProps): React.JSX.Element;
+export declare function useAlgoMetricsContext(): AlgoMetricsContextValue;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAKpF,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,GAAG,EAAE,WAAW,EAChB,QAAQ,GACT,EAAE,wBAAwB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA4C9C;AAED,wBAAgB,qBAAqB,IAAI,uBAAuB,CAM/D"}

package/dist/context.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useState } from 'react';
+import { AlgoMetricsSDK } from '@d13co/algo-metrics-sdk';
+import { isMainnetGenesisHash } from './compute.js';
+const AlgoMetricsContext = createContext(null);
+export function AlgoMetricsProvider({ options, sdk: externalSdk, children, }) {
+    const sdk = useMemo(() => externalSdk ?? new AlgoMetricsSDK(options), [externalSdk, options]);
+    const [data, setData] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [isMainnet, setIsMainnet] = useState(true);
+    useEffect(() => {
+        const controller = new AbortController();
+        void (async () => {
+            try {
+                const params = await sdk.algorand.client.algod.getTransactionParams().do();
+                if (!controller.signal.aborted) {
+                    setIsMainnet(isMainnetGenesisHash(params.genesisHash));
+                }
+            }
+            catch {
+                // detection failed — keep default (true)
+            }
+        })();
+        return () => {
+            controller.abort();
+        };
+    }, [sdk]);
+    useEffect(() => {
+        const callback = (blocks) => {
+            setData(blocks);
+            setIsLoading(false);
+        };
+        void sdk.registerTsTcWatcher(callback, { numBlocks: 1000 });
+        return () => {
+            sdk.unregisterTsTcWatcher(callback);
+        };
+    }, [sdk]);
+    const value = useMemo(() => ({ data, isLoading, sdk, isMainnet }), [data, isLoading, sdk, isMainnet]);
+    return _jsx(AlgoMetricsContext, { value: value, children: children });
+}
+export function useAlgoMetricsContext() {
+    const context = useContext(AlgoMetricsContext);
+    if (context === null) {
+        throw new Error('useAlgoMetricsContext must be used within an AlgoMetricsProvider');
+    }
+    return context;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,kBAAkB,GAAG,aAAa,CAAiC,IAAI,CAAC,CAAC;AAE/E,MAAM,UAAU,mBAAmB,CAAC,EAClC,OAAO,EACP,GAAG,EAAE,WAAW,EAChB,QAAQ,GACiB;IACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,IAAI,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAE9F,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAA+B,IAAI,CAAC,CAAC;IACrE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,KAAK,CAAC,KAAK,IAAmB,EAAE;YAC9B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3E,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC/B,YAAY,CAAC,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,yCAAyC;YAC3C,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAS,EAAE;YAChB,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,CAAC,MAA6B,EAAQ,EAAE;YACvD,OAAO,CAAC,MAAM,CAAC,CAAC;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC;QAEF,KAAK,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5D,OAAO,GAAS,EAAE;YAChB,GAAG,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,MAAM,KAAK,GAAG,OAAO,CACnB,GAA4B,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EACpE,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,CAAC,CAClC,CAAC;IAEF,OAAO,KAAC,kBAAkB,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAsB,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC/C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,7 @@
+import type { BlockRoundTimeAndTc } from '@d13co/algo-metrics-sdk';
+export declare function useLatestRound(): bigint | null;
+export declare function useAverageRoundTime(): number | null;
+export declare function useTransactionsPerSecond(): number | null;
+export declare function useTransactionCount(): bigint | null;
+export declare function useBlockData(): BlockRoundTimeAndTc[] | null;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AASnE,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAG9C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAGnD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAGxD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAGnD;AAED,wBAAgB,YAAY,IAAI,mBAAmB,EAAE,GAAG,IAAI,CAG3D"}

package/dist/hooks.js

@@ -0,0 +1,24 @@
+import { useMemo } from 'react';
+import { useAlgoMetricsContext } from './context.js';
+import { getLatestRound, getAverageRoundTime, getTransactionsPerSecond, getTransactionCount, } from './compute.js';
+export function useLatestRound() {
+    const { data } = useAlgoMetricsContext();
+    return useMemo(() => (data ? getLatestRound(data) : null), [data]);
+}
+export function useAverageRoundTime() {
+    const { data } = useAlgoMetricsContext();
+    return useMemo(() => (data ? getAverageRoundTime(data) : null), [data]);
+}
+export function useTransactionsPerSecond() {
+    const { data } = useAlgoMetricsContext();
+    return useMemo(() => (data ? getTransactionsPerSecond(data) : null), [data]);
+}
+export function useTransactionCount() {
+    const { data, isMainnet } = useAlgoMetricsContext();
+    return useMemo(() => (data ? getTransactionCount(data, isMainnet) : null), [data, isMainnet]);
+}
+export function useBlockData() {
+    const { data } = useAlgoMetricsContext();
+    return data;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,IAAI,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACzC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,EAAE,IAAI,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACzC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,MAAM,EAAE,IAAI,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACzC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACpD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,EAAE,IAAI,EAAE,GAAG,qBAAqB,EAAE,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { AlgoMetricsProvider, useAlgoMetricsContext } from './context.js';
+export { useLatestRound, useAverageRoundTime, useTransactionsPerSecond, useTransactionCount, useBlockData, } from './hooks.js';
+export { getLatestRound, getAverageRoundTime, getTransactionsPerSecond, getTransactionCount, isMainnetGenesisHash, MAINNET_TC_OFFSET, MAINNET_GENESIS_HASH, } from './compute.js';
+export type { AlgoMetricsContextValue, AlgoMetricsProviderProps } from './types.js';
+export type { BlockRoundTimeAndTc } from '@d13co/algo-metrics-sdk';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { AlgoMetricsProvider, useAlgoMetricsContext } from './context.js';
+export { useLatestRound, useAverageRoundTime, useTransactionsPerSecond, useTransactionCount, useBlockData, } from './hooks.js';
+export { getLatestRound, getAverageRoundTime, getTransactionsPerSecond, getTransactionCount, isMainnetGenesisHash, MAINNET_TC_OFFSET, MAINNET_GENESIS_HASH, } from './compute.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+import type { BlockRoundTimeAndTc, AlgoMetricsSDK, AlgoMetricsSDKOptions } from '@d13co/algo-metrics-sdk';
+export interface AlgoMetricsContextValue {
+    data: BlockRoundTimeAndTc[] | null;
+    isLoading: boolean;
+    sdk: AlgoMetricsSDK;
+    isMainnet: boolean;
+}
+export interface AlgoMetricsProviderProps {
+    options?: AlgoMetricsSDKOptions;
+    sdk?: AlgoMetricsSDK;
+    children: React.ReactNode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@d13co/algo-metrics-react",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "React hooks for @d13co/algo-metrics-sdk",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:d13co/algo-metrics-sdk.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/d13co/algo-metrics-sdk/issues"
+  },
+  "homepage": "https://github.com/d13co/algo-metrics-sdk/tree/main/packages/react#readme",
+  "dependencies": {
+    "@d13co/algo-metrics-sdk": "1.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}