@arkade-os/sdk 0.4.26 → 0.4.28

package/dist/cjs/providers/errors.js

@@ -1,59 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArkError = void 0;
-exports.maybeArkError = maybeArkError;
-class ArkError extends Error {
-    constructor(code, message, name, metadata) {
-        super(message);
-        this.code = code;
-        this.message = message;
-        this.name = name;
-        this.metadata = metadata;
-    }
-}
-exports.ArkError = ArkError;
-/**
- * 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
- */
-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/cjs/providers/expoArk.js

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpoArkProvider = void 0;
-const ark_1 = require("./ark");
-const expoUtils_1 = require("./expoUtils");
-/**
- * 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();
- * ```
- */
-class ExpoArkProvider extends ark_1.RestArkProvider {
-    constructor(serverUrl) {
-        super(serverUrl);
-    }
-    async *getEventStream(signal, topics) {
-        const expoFetch = await (0, expoUtils_1.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* (0, expoUtils_1.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 ((0, ark_1.isFetchTimeoutError)(error)) {
-                    console.debug("Timeout error ignored");
-                    continue;
-                }
-                console.error("Event stream error:", error);
-                throw error;
-            }
-        }
-    }
-    async *getTransactionsStream(signal) {
-        const expoFetch = await (0, expoUtils_1.getExpoFetch)();
-        const url = `${this.serverUrl}/v1/txs`;
-        while (!signal?.aborted) {
-            try {
-                yield* (0, expoUtils_1.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 ((0, ark_1.isFetchTimeoutError)(error)) {
-                    console.debug("Timeout error ignored");
-                    continue;
-                }
-                console.error("Transaction stream error:", error);
-                throw error;
-            }
-        }
-    }
-}
-exports.ExpoArkProvider = ExpoArkProvider;

package/dist/cjs/providers/expoIndexer.js

@@ -1,111 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpoIndexerProvider = void 0;
-const indexer_1 = require("./indexer");
-const ark_1 = require("./ark");
-const expoUtils_1 = require("./expoUtils");
-// 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'] });
- * ```
- */
-class ExpoIndexerProvider extends indexer_1.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 (0, expoUtils_1.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* (0, expoUtils_1.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 ((0, ark_1.isFetchTimeoutError)(error)) {
-                    console.debug("Timeout error ignored");
-                    continue;
-                }
-                console.error("Subscription error:", error);
-                throw error;
-            }
-        }
-    }
-}
-exports.ExpoIndexerProvider = ExpoIndexerProvider;

package/dist/cjs/providers/expoUtils.js

@@ -1,124 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getExpoFetch = getExpoFetch;
-exports.sseStreamIterator = sseStreamIterator;
-/**
- * Dynamically imports expo/fetch with fallback to standard fetch.
- * @returns A fetch function suitable for SSE streaming
- */
-async function getExpoFetch(options) {
-    const requireExpo = options?.requireExpo ?? false;
-    try {
-        const expoFetchModule = await Promise.resolve().then(() => __importStar(require("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
- */
-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);
-    }
-}