@arkade-os/sdk 0.4.27 → 0.4.28

package/dist/esm/providers/errors.js

@@ -1,54 +0,0 @@
-export class ArkError extends Error {
-    constructor(code, message, name, metadata) {
-        super(message);
-        this.code = code;
-        this.message = message;
-        this.name = name;
-        this.metadata = metadata;
-    }
-}
-/**
- * Try to convert an error to an ArkError class, returning undefined if the error is not an ArkError
- * @param error - The error to parse
- * @returns The parsed ArkError, or undefined if the error is not an ArkError
- */
-export function maybeArkError(error) {
-    try {
-        if (!(error instanceof Error))
-            return undefined;
-        const decoded = JSON.parse(error.message);
-        if (!("details" in decoded))
-            return undefined;
-        if (!Array.isArray(decoded.details))
-            return undefined;
-        // search for a valid details object with the correct type
-        for (const details of decoded.details) {
-            if (!("@type" in details))
-                continue;
-            const type = details["@type"];
-            if (type !== "type.googleapis.com/ark.v1.ErrorDetails")
-                continue;
-            if (!("code" in details))
-                continue;
-            const code = details.code;
-            if (!("message" in details))
-                continue;
-            const message = details.message;
-            if (!("name" in details))
-                continue;
-            const name = details.name;
-            let metadata;
-            if ("metadata" in details && isMetadata(details.metadata)) {
-                metadata = details.metadata;
-            }
-            return new ArkError(code, message, name, metadata);
-        }
-        return undefined;
-    }
-    catch (e) {
-        return undefined;
-    }
-}
-function isMetadata(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}

package/dist/esm/providers/expoArk.js

@@ -1,78 +0,0 @@
-import { RestArkProvider, isFetchTimeoutError, } from "./ark.js";
-import { getExpoFetch, sseStreamIterator } from "./expoUtils.js";
-/**
- * Expo-compatible Arkade provider implementation using expo/fetch for SSE support.
- * This provider works specifically in React Native/Expo environments where
- * standard EventSource is not available but expo/fetch provides SSE capabilities.
- *
- * @example
- * ```typescript
- * import { ExpoArkProvider } from '@arkade-os/sdk/providers/expo';
- *
- * const provider = new ExpoArkProvider('https://arkade.computer');
- * const info = await provider.getInfo();
- * ```
- */
-export class ExpoArkProvider extends RestArkProvider {
-    constructor(serverUrl) {
-        super(serverUrl);
-    }
-    async *getEventStream(signal, topics) {
-        const expoFetch = await getExpoFetch();
-        const url = `${this.serverUrl}/v1/batch/events`;
-        const queryParams = topics.length > 0
-            ? `?${topics.map((topic) => `topics=${encodeURIComponent(topic)}`).join("&")}`
-            : "";
-        while (!signal?.aborted) {
-            try {
-                yield* sseStreamIterator(url + queryParams, signal, expoFetch, {}, (data) => {
-                    // Handle different response structures
-                    // v8 mesh API might wrap in {result: ...} or send directly
-                    const eventData = data.result || data;
-                    // Skip heartbeat messages
-                    if (eventData.heartbeat !== undefined) {
-                        return null;
-                    }
-                    return this.parseSettlementEvent(eventData);
-                });
-            }
-            catch (error) {
-                if (error instanceof Error && error.name === "AbortError") {
-                    break;
-                }
-                // ignore timeout errors, they're expected when the server is not sending anything for 5 min
-                // these timeouts are set by expo/fetch function
-                if (isFetchTimeoutError(error)) {
-                    console.debug("Timeout error ignored");
-                    continue;
-                }
-                console.error("Event stream error:", error);
-                throw error;
-            }
-        }
-    }
-    async *getTransactionsStream(signal) {
-        const expoFetch = await getExpoFetch();
-        const url = `${this.serverUrl}/v1/txs`;
-        while (!signal?.aborted) {
-            try {
-                yield* sseStreamIterator(url, signal, expoFetch, {}, (data) => {
-                    return this.parseTransactionNotification(data.result);
-                });
-            }
-            catch (error) {
-                if (error instanceof Error && error.name === "AbortError") {
-                    break;
-                }
-                // ignore timeout errors, they're expected when the server is not sending anything for 5 min
-                // these timeouts are set by expo/fetch function
-                if (isFetchTimeoutError(error)) {
-                    console.debug("Timeout error ignored");
-                    continue;
-                }
-                console.error("Transaction stream error:", error);
-                throw error;
-            }
-        }
-    }
-}

package/dist/esm/providers/expoIndexer.js

@@ -1,107 +0,0 @@
-import { RestIndexerProvider } from "./indexer.js";
-import { isFetchTimeoutError } from "./ark.js";
-import { getExpoFetch, sseStreamIterator } from "./expoUtils.js";
-// Helper function to convert Vtxo to VirtualCoin (same as in indexer.ts)
-function convertVtxo(vtxo) {
-    return {
-        txid: vtxo.outpoint.txid,
-        vout: vtxo.outpoint.vout,
-        value: Number(vtxo.amount),
-        status: {
-            confirmed: !vtxo.isSwept && !vtxo.isPreconfirmed,
-            isLeaf: !vtxo.isPreconfirmed,
-        },
-        virtualStatus: {
-            state: vtxo.isSwept
-                ? "swept"
-                : vtxo.isPreconfirmed
-                    ? "preconfirmed"
-                    : "settled",
-            commitmentTxIds: vtxo.commitmentTxids,
-            batchExpiry: vtxo.expiresAt
-                ? Number(vtxo.expiresAt) * 1000
-                : undefined,
-        },
-        spentBy: vtxo.spentBy ?? "",
-        settledBy: vtxo.settledBy,
-        arkTxId: vtxo.arkTxid,
-        createdAt: new Date(Number(vtxo.createdAt) * 1000),
-        isUnrolled: vtxo.isUnrolled,
-        isSpent: vtxo.isSpent,
-        script: vtxo.script,
-        assets: vtxo.assets?.map((a) => ({
-            assetId: a.assetId,
-            amount: BigInt(a.amount),
-        })),
-    };
-}
-/**
- * Expo-compatible Indexer provider implementation using expo/fetch for streaming support.
- * This provider works specifically in React Native/Expo environments where
- * standard fetch streaming may not work properly but expo/fetch provides streaming capabilities.
- *
- * @example
- * ```typescript
- * import { ExpoIndexerProvider } from '@arkade-os/sdk/adapters/expo';
- *
- * const provider = new ExpoIndexerProvider('https://indexer.example.com');
- * const vtxos = await provider.getVtxos({ scripts: ['script1'] });
- * ```
- */
-export class ExpoIndexerProvider extends RestIndexerProvider {
-    constructor(serverUrl) {
-        super(serverUrl);
-    }
-    async *getSubscription(subscriptionId, abortSignal) {
-        // Detect if we're running in React Native/Expo environment
-        const isReactNative = typeof navigator !== "undefined" &&
-            navigator.product === "ReactNative";
-        const expoFetch = await getExpoFetch().catch((error) => {
-            // In React Native/Expo, expo/fetch is required for proper streaming support
-            if (isReactNative) {
-                throw new Error("expo/fetch is unavailable in React Native environment. " +
-                    "Please ensure expo/fetch is installed and properly configured. " +
-                    "Streaming support may not work with standard fetch in React Native.");
-            }
-            throw error;
-        });
-        const url = `${this.serverUrl}/v1/indexer/script/subscription/${subscriptionId}`;
-        while (!abortSignal.aborted) {
-            try {
-                yield* sseStreamIterator(url, abortSignal, expoFetch, { "Content-Type": "application/json" }, (data) => {
-                    // Handle new v8 proto format with heartbeat or event
-                    if (data.heartbeat !== undefined) {
-                        // Skip heartbeat messages
-                        return null;
-                    }
-                    // Process event messages
-                    if (data.event) {
-                        return {
-                            txid: data.event.txid,
-                            scripts: data.event.scripts || [],
-                            newVtxos: (data.event.newVtxos || []).map(convertVtxo),
-                            spentVtxos: (data.event.spentVtxos || []).map(convertVtxo),
-                            sweptVtxos: (data.event.sweptVtxos || []).map(convertVtxo),
-                            tx: data.event.tx,
-                            checkpointTxs: data.event.checkpointTxs,
-                        };
-                    }
-                    return null;
-                });
-            }
-            catch (error) {
-                if (error instanceof Error && error.name === "AbortError") {
-                    break;
-                }
-                // ignore timeout errors, they're expected when the server is not sending anything for 5 min
-                // these timeouts are set by expo/fetch function
-                if (isFetchTimeoutError(error)) {
-                    console.debug("Timeout error ignored");
-                    continue;
-                }
-                console.error("Subscription error:", error);
-                throw error;
-            }
-        }
-    }
-}

package/dist/esm/providers/expoUtils.js

@@ -1,87 +0,0 @@
-/**
- * Dynamically imports expo/fetch with fallback to standard fetch.
- * @returns A fetch function suitable for SSE streaming
- */
-export async function getExpoFetch(options) {
-    const requireExpo = options?.requireExpo ?? false;
-    try {
-        const expoFetchModule = await import("expo/fetch");
-        console.debug("Using expo/fetch for streaming");
-        return expoFetchModule.fetch;
-    }
-    catch (error) {
-        if (requireExpo) {
-            throw new Error("expo/fetch is unavailable in this environment. " +
-                "Please ensure expo/fetch is installed and properly configured.");
-        }
-        console.warn("Using standard fetch instead of expo/fetch. " +
-            "Streaming may not be fully supported in some environments.", error);
-        return fetch;
-    }
-}
-/**
- * Generic SSE stream processor using fetch API with ReadableStream.
- * Handles SSE format parsing, buffer management, and abort signals.
- *
- * @param url - The SSE endpoint URL
- * @param abortSignal - Signal to abort the stream
- * @param fetchFn - Fetch function to use (defaults to standard fetch)
- * @param headers - Additional headers to send
- * @param parseData - Function to parse and yield data from SSE events
- */
-export async function* sseStreamIterator(url, abortSignal, fetchFn, headers, parseData) {
-    const fetchController = new AbortController();
-    const cleanup = () => fetchController.abort();
-    abortSignal?.addEventListener("abort", cleanup, { once: true });
-    try {
-        const response = await fetchFn(url, {
-            headers: {
-                Accept: "text/event-stream",
-                ...headers,
-            },
-            signal: fetchController.signal,
-        });
-        if (!response.ok) {
-            throw new Error(`Unexpected status ${response.status} when fetching SSE stream`);
-        }
-        if (!response.body) {
-            throw new Error("Response body is null");
-        }
-        const reader = response.body.getReader();
-        const decoder = new TextDecoder();
-        let buffer = "";
-        while (!abortSignal?.aborted) {
-            const { done, value } = await reader.read();
-            if (done) {
-                break;
-            }
-            buffer += decoder.decode(value, { stream: true });
-            const lines = buffer.split("\n");
-            for (let i = 0; i < lines.length - 1; i++) {
-                const line = lines[i].trim();
-                if (!line)
-                    continue;
-                if (line.startsWith("data:")) {
-                    const jsonStr = line.substring(5).trim();
-                    if (!jsonStr)
-                        continue;
-                    try {
-                        const data = JSON.parse(jsonStr);
-                        const parsed = parseData(data);
-                        if (parsed !== null) {
-                            yield parsed;
-                        }
-                    }
-                    catch (parseError) {
-                        console.error("Failed to parse SSE data:", parseError);
-                        throw parseError;
-                    }
-                }
-            }
-            buffer = lines[lines.length - 1];
-        }
-    }
-    finally {
-        abortSignal?.removeEventListener("abort", cleanup);
-    }
-}