@rotateprotocol/sdk 1.0.0

package/dist/react.js

@@ -0,0 +1,429 @@
+"use strict";
+/**
+ * Rotate Protocol React Hooks
+ *
+ * React hooks for easy integration with Solana wallet adapters.
+ *
+ * @packageDocumentation
+ */
+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.RotatePlatformManager = exports.MarketplaceCart = exports.RotateMarketplace = exports.RotateCart = exports.RotateStore = exports.MAX_RANDOM_ID = exports.MIN_RANDOM_ID = exports.MEMO_PROGRAM_ID = exports.getLinkDescription = exports.isValidId = exports.generateSampleId = exports.calculateFees = exports.RotateSDK = exports.useMarketplaceCart = exports.useMarketplace = exports.useCart = exports.useProducts = void 0;
+exports.useRotate = useRotate;
+exports.usePaymentLink = usePaymentLink;
+exports.useMerchant = useMerchant;
+exports.useSolPrice = useSolPrice;
+exports.useTokenBalances = useTokenBalances;
+exports.usePaymentFlow = usePaymentFlow;
+exports.useCreateEntities = useCreateEntities;
+const react_1 = require("react");
+const wallet_adapter_react_1 = require("@solana/wallet-adapter-react");
+const index_1 = __importStar(require("./index"));
+exports.RotateSDK = index_1.default;
+Object.defineProperty(exports, "calculateFees", { enumerable: true, get: function () { return index_1.calculateFees; } });
+Object.defineProperty(exports, "generateSampleId", { enumerable: true, get: function () { return index_1.generateSampleId; } });
+Object.defineProperty(exports, "isValidId", { enumerable: true, get: function () { return index_1.isValidId; } });
+Object.defineProperty(exports, "getLinkDescription", { enumerable: true, get: function () { return index_1.getLinkDescription; } });
+Object.defineProperty(exports, "MEMO_PROGRAM_ID", { enumerable: true, get: function () { return index_1.MEMO_PROGRAM_ID; } });
+Object.defineProperty(exports, "MIN_RANDOM_ID", { enumerable: true, get: function () { return index_1.MIN_RANDOM_ID; } });
+Object.defineProperty(exports, "MAX_RANDOM_ID", { enumerable: true, get: function () { return index_1.MAX_RANDOM_ID; } });
+// ==================== MAIN HOOK ====================
+/**
+ * Main hook for Rotate Protocol
+ */
+function useRotate(options = {}) {
+    const { connection } = (0, wallet_adapter_react_1.useConnection)();
+    const wallet = (0, wallet_adapter_react_1.useWallet)();
+    const sdk = (0, react_1.useMemo)(() => {
+        return new index_1.default({
+            network: options.network || 'mainnet-beta',
+            rpcEndpoint: options.rpcEndpoint,
+        });
+    }, [options.network, options.rpcEndpoint]);
+    const [protocol, setProtocol] = (0, react_1.useState)(null);
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    // Load protocol on mount
+    (0, react_1.useEffect)(() => {
+        async function load() {
+            try {
+                const data = await sdk.getProtocol();
+                setProtocol(data);
+            }
+            catch (e) {
+                setError(e.message);
+            }
+            finally {
+                setLoading(false);
+            }
+        }
+        load();
+    }, [sdk]);
+    return {
+        sdk,
+        protocol,
+        loading,
+        error,
+        connected: wallet.connected,
+        publicKey: wallet.publicKey,
+        signTransaction: wallet.signTransaction,
+    };
+}
+// ==================== PAYMENT LINK HOOK ====================
+/**
+ * Hook for working with a specific payment link
+ */
+function usePaymentLink(linkId, options = {}) {
+    const { sdk } = useRotate(options);
+    const [link, setLink] = (0, react_1.useState)(null);
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    // Load link data
+    const refresh = (0, react_1.useCallback)(async () => {
+        setLoading(true);
+        try {
+            const data = await sdk.getPaymentLink(linkId);
+            setLink(data);
+            setError(null);
+        }
+        catch (e) {
+            setError(e.message);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [sdk, linkId]);
+    (0, react_1.useEffect)(() => {
+        refresh();
+    }, [refresh]);
+    // Poll for updates
+    const [polling, setPolling] = (0, react_1.useState)(false);
+    const pollIntervalRef = (0, react_1.useRef)(2000);
+    const startPolling = (0, react_1.useCallback)((intervalMs = 2000) => {
+        pollIntervalRef.current = intervalMs;
+        setPolling(true);
+    }, []);
+    const stopPolling = (0, react_1.useCallback)(() => {
+        setPolling(false);
+    }, []);
+    (0, react_1.useEffect)(() => {
+        if (!polling)
+            return;
+        const interval = setInterval(refresh, pollIntervalRef.current);
+        return () => clearInterval(interval);
+    }, [polling, refresh]);
+    // Status helpers
+    const status = link ? {
+        linkId: link.id,
+        status: link.status,
+        amountPaid: link.amountPaid,
+        amountTotal: link.amount,
+        isPaid: link.status === 'Paid',
+        isExpired: link.expiresAt > 0 && Date.now() / 1000 > link.expiresAt,
+    } : null;
+    return {
+        link,
+        status,
+        loading,
+        error,
+        refresh,
+        startPolling,
+        stopPolling,
+        isPolling: polling,
+        paymentUrl: sdk.getPaymentUrl(linkId),
+    };
+}
+// ==================== MERCHANT HOOK ====================
+/**
+ * Hook for merchant operations
+ */
+function useMerchant(merchantId, options = {}) {
+    const { sdk } = useRotate(options);
+    const [merchant, setMerchant] = (0, react_1.useState)(null);
+    const [platform, setPlatform] = (0, react_1.useState)(null);
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        async function load() {
+            try {
+                const merchantData = await sdk.getMerchant(merchantId);
+                setMerchant(merchantData);
+                if (merchantData) {
+                    const platformData = await sdk.getPlatform(merchantData.platformId);
+                    setPlatform(platformData);
+                }
+            }
+            catch (e) {
+                setError(e.message);
+            }
+            finally {
+                setLoading(false);
+            }
+        }
+        load();
+    }, [sdk, merchantId]);
+    // Calculate fees helper
+    const getFees = (0, react_1.useCallback)((amountUsd) => {
+        return (0, index_1.calculateFees)(amountUsd, platform?.feeBps || 0);
+    }, [platform]);
+    return {
+        merchant,
+        platform,
+        loading,
+        error,
+        getFees,
+    };
+}
+// ==================== SOL PRICE HOOK ====================
+/**
+ * Hook for SOL price.
+ * `priceApiUrl` can be overridden to use a custom price feed (default: CoinGecko).
+ */
+function useSolPrice(refreshIntervalMs = 30000, priceApiUrl = 'https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd') {
+    const [price, setPrice] = (0, react_1.useState)(null);
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const refresh = (0, react_1.useCallback)(async () => {
+        try {
+            const response = await fetch(priceApiUrl);
+            const data = await response.json();
+            setPrice(data.solana?.usd || null);
+        }
+        catch {
+            // Ignore errors
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [priceApiUrl]);
+    (0, react_1.useEffect)(() => {
+        refresh();
+        const interval = setInterval(refresh, refreshIntervalMs);
+        return () => clearInterval(interval);
+    }, [refresh, refreshIntervalMs]);
+    const usdToSol = (0, react_1.useCallback)((usd) => {
+        if (!price)
+            return null;
+        return usd / price;
+    }, [price]);
+    const solToUsd = (0, react_1.useCallback)((sol) => {
+        if (!price)
+            return null;
+        return sol * price;
+    }, [price]);
+    return {
+        price,
+        loading,
+        refresh,
+        usdToSol,
+        solToUsd,
+    };
+}
+// ==================== TOKEN BALANCE HOOK ====================
+/**
+ * Hook for token balances
+ */
+function useTokenBalances(options = {}) {
+    const { sdk } = useRotate(options);
+    const { publicKey, connected } = (0, wallet_adapter_react_1.useWallet)();
+    const { connection } = (0, wallet_adapter_react_1.useConnection)();
+    const [balances, setBalances] = (0, react_1.useState)({ sol: 0, usdc: 0, usdt: 0 });
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const refresh = (0, react_1.useCallback)(async () => {
+        if (!publicKey)
+            return;
+        setLoading(true);
+        try {
+            const [solBalance, usdcBalance, usdtBalance] = await Promise.all([
+                connection.getBalance(publicKey),
+                sdk.getTokenBalance(publicKey, 'USDC'),
+                sdk.getTokenBalance(publicKey, 'USDT'),
+            ]);
+            setBalances({
+                sol: solBalance / 1e9,
+                usdc: usdcBalance,
+                usdt: usdtBalance,
+            });
+        }
+        catch {
+            // Ignore errors
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [connection, publicKey, sdk]);
+    (0, react_1.useEffect)(() => {
+        if (connected && publicKey) {
+            refresh();
+        }
+    }, [connected, publicKey, refresh]);
+    return {
+        balances,
+        loading,
+        refresh,
+        hasEnough: (amount, currency) => {
+            const balance = currency === 'SOL' ? balances.sol :
+                currency === 'USDC' ? balances.usdc :
+                    balances.usdt;
+            return balance >= amount;
+        },
+    };
+}
+// ==================== PAYMENT FLOW HOOK ====================
+/**
+ * Complete payment flow hook
+ */
+function usePaymentFlow(linkId, options = {}) {
+    const { sdk, connected, publicKey } = useRotate(options);
+    const { link, status, refresh, startPolling, stopPolling } = usePaymentLink(linkId, options);
+    const { price: solPrice } = useSolPrice();
+    const { balances } = useTokenBalances(options);
+    const [selectedCurrency, setSelectedCurrency] = (0, react_1.useState)('USDC');
+    const [paying, setPaying] = (0, react_1.useState)(false);
+    const [paymentError, setPaymentError] = (0, react_1.useState)(null);
+    // Calculate amount in selected currency, accounting for link token type
+    const amountInCurrency = (0, react_1.useMemo)(() => {
+        if (!link)
+            return null;
+        // SOL-denominated links store lamports (9 decimals)
+        if (link.tokenType === 'Sol') {
+            return Number(link.amount) / 1000000000;
+        }
+        // USD / USDC / USDT links store micro-units (6 decimals)
+        const amountUsd = Number(link.amount) / 1000000;
+        if (selectedCurrency === 'SOL' && solPrice) {
+            return amountUsd / solPrice;
+        }
+        // USDC/USDT are 1:1 with USD
+        return amountUsd;
+    }, [link, selectedCurrency, solPrice]);
+    // Check if user can pay
+    const canPay = (0, react_1.useMemo)(() => {
+        if (!connected || !link || !amountInCurrency)
+            return false;
+        if (link.status !== 'Pending' && link.status !== 'PartiallyPaid')
+            return false;
+        const balance = selectedCurrency === 'SOL' ? balances.sol :
+            selectedCurrency === 'USDC' ? balances.usdc :
+                balances.usdt;
+        return balance >= amountInCurrency;
+    }, [connected, link, amountInCurrency, selectedCurrency, balances]);
+    return {
+        link,
+        status,
+        connected,
+        publicKey,
+        selectedCurrency,
+        setSelectedCurrency,
+        amountInCurrency,
+        canPay,
+        paying,
+        paymentError,
+        refresh,
+        startPolling,
+        stopPolling,
+        balances,
+        solPrice,
+    };
+}
+// ==================== PLATFORM/MERCHANT CREATION HOOK ====================
+/**
+ * Hook for creating platforms and merchants with random IDs
+ */
+function useCreateEntities(options = {}) {
+    const { sdk, connected, publicKey } = useRotate(options);
+    const [creating, setCreating] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const createPlatform = (0, react_1.useCallback)(async (feeBps, wallet) => {
+        if (!connected)
+            throw new Error('Wallet not connected');
+        setCreating(true);
+        setError(null);
+        try {
+            const result = await sdk.createPlatform({ feeBps, wallet });
+            return result;
+        }
+        catch (e) {
+            setError(e.message);
+            throw e;
+        }
+        finally {
+            setCreating(false);
+        }
+    }, [sdk, connected]);
+    const createMerchant = (0, react_1.useCallback)(async (platformId, wallet) => {
+        if (!connected)
+            throw new Error('Wallet not connected');
+        setCreating(true);
+        setError(null);
+        try {
+            const result = await sdk.createMerchant({ platformId, wallet });
+            return result;
+        }
+        catch (e) {
+            setError(e.message);
+            throw e;
+        }
+        finally {
+            setCreating(false);
+        }
+    }, [sdk, connected]);
+    return {
+        createPlatform,
+        createMerchant,
+        creating,
+        error,
+        generateSampleId: index_1.generateSampleId,
+        isValidId: index_1.isValidId,
+        MIN_RANDOM_ID: index_1.MIN_RANDOM_ID,
+        MAX_RANDOM_ID: index_1.MAX_RANDOM_ID,
+    };
+}
+// ==================== STORE & MARKETPLACE HOOKS ====================
+// Re-export from hooks module for convenience
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "useProducts", { enumerable: true, get: function () { return hooks_1.useProducts; } });
+Object.defineProperty(exports, "useCart", { enumerable: true, get: function () { return hooks_1.useCart; } });
+Object.defineProperty(exports, "useMarketplace", { enumerable: true, get: function () { return hooks_1.useMarketplace; } });
+Object.defineProperty(exports, "useMarketplaceCart", { enumerable: true, get: function () { return hooks_1.useMarketplaceCart; } });
+// Re-export store, marketplace & platform classes
+var store_1 = require("./store");
+Object.defineProperty(exports, "RotateStore", { enumerable: true, get: function () { return store_1.RotateStore; } });
+Object.defineProperty(exports, "RotateCart", { enumerable: true, get: function () { return store_1.RotateCart; } });
+var marketplace_1 = require("./marketplace");
+Object.defineProperty(exports, "RotateMarketplace", { enumerable: true, get: function () { return marketplace_1.RotateMarketplace; } });
+Object.defineProperty(exports, "MarketplaceCart", { enumerable: true, get: function () { return marketplace_1.MarketplaceCart; } });
+var platform_1 = require("./platform");
+Object.defineProperty(exports, "RotatePlatformManager", { enumerable: true, get: function () { return platform_1.RotatePlatformManager; } });
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Rotate Store — Product Catalog, Cart & Checkout
+ *
+ * A complete store layer that sits on top of the Rotate Protocol.
+ * Products and cart state are managed client-side / in your database;
+ * only the final payment touches the blockchain.
+ *
+ * @example
+ * ```ts
+ * const store = new RotateStore(sdk, {
+ *   merchantId: 1000000,
+ *   platformId: 1000000,
+ *   currency: 'USD',
+ * });
+ *
+ * store.addProduct({ id: 'tshirt-01', name: 'Logo Tee', price: 29.99, inventory: 100 });
+ * store.addProduct({ id: 'hoodie-01', name: 'Zip Hoodie', price: 59.99, inventory: 50 });
+ *
+ * const cart = store.createCart();
+ * cart.addItem('tshirt-01', 2);
+ * cart.addItem('hoodie-01', 1);
+ *
+ * const session = await cart.checkout(); // creates on-chain payment link
+ * console.log(session.linkId, session.paymentUrl);
+ * ```
+ *
+ * @packageDocumentation
+ */
+import RotateSDK from './index';
+import { BaseProduct, BaseProductInput, Discount, DiscountInput } from './catalog';
+export type Currency = 'SOL' | 'USDC' | 'USDT' | 'USD';
+/** A product in the catalog */
+export interface Product extends BaseProduct {
+}
+export interface ProductInput extends BaseProductInput {
+}
+/** A line item in a cart */
+export interface LineItem {
+    product: Product;
+    quantity: number;
+    /** Per-item price override (for dynamic pricing / discounts) */
+    unitPrice: number;
+}
+export type { Discount, DiscountInput } from './catalog';
+/** Cart totals breakdown */
+export interface CartTotals {
+    /** Number of unique items */
+    itemCount: number;
+    /** Total quantity across all items */
+    totalQuantity: number;
+    /** Subtotal before discounts and fees */
+    subtotal: number;
+    /** Total discount amount */
+    discountAmount: number;
+    /** Subtotal after discounts, before fees */
+    afterDiscount: number;
+    /** Buyer's fee share (protocol + platform) */
+    fees: number;
+    /** Grand total the buyer pays */
+    total: number;
+    /** What the merchant receives after seller-side fee deduction */
+    merchantReceives: number;
+    /** Line-by-line breakdown */
+    lines: Array<{
+        productId: string;
+        name: string;
+        quantity: number;
+        unitPrice: number;
+        lineTotal: number;
+    }>;
+}
+/** Result of a checkout */
+export interface CheckoutResult {
+    /** On-chain link ID */
+    linkId: number;
+    /** Transaction signature */
+    tx: string;
+    /** Payment URL */
+    paymentUrl: string;
+    /** QR code URL */
+    qrCodeUrl: string;
+    /** Cart totals at time of checkout */
+    totals: CartTotals;
+    /** Order reference */
+    orderRef: string;
+    /** Created timestamp */
+    createdAt: number;
+}
+/** Batch link creation result */
+export interface BatchLinkResult {
+    productId: string;
+    linkId: number;
+    tx: string;
+    paymentUrl: string;
+}
+/** Store configuration */
+export interface StoreConfig {
+    merchantId: number;
+    platformId: number;
+    /** Default currency for the store */
+    currency?: Currency;
+    /** Allow tips on checkout */
+    allowTips?: boolean;
+    /** Default link expiration in seconds (0 = never, default: 300 = 5min) */
+    defaultExpiresIn?: number;
+    /** Platform fee BPS for fee calculations */
+    platformFeeBps?: number;
+}
+export declare class RotateStore {
+    private sdk;
+    private config;
+    /** @internal Shared catalog logic */
+    private catalog;
+    constructor(sdk: RotateSDK, config: StoreConfig);
+    addProduct(input: ProductInput): Product;
+    addProducts(inputs: ProductInput[]): Product[];
+    updateProduct(id: string, updates: Partial<ProductInput>): Product;
+    removeProduct(id: string): boolean;
+    getProduct(id: string): Product | undefined;
+    getProducts(filter?: {
+        category?: string;
+        active?: boolean;
+        search?: string;
+        minPrice?: number;
+        maxPrice?: number;
+        sortBy?: 'name' | 'price' | 'createdAt';
+        sortOrder?: 'asc' | 'desc';
+        limit?: number;
+        offset?: number;
+    }): Product[];
+    getCategories(): string[];
+    get productCount(): number;
+    isInStock(productId: string, quantity?: number): boolean;
+    reserveInventory(productId: string, quantity: number): void;
+    releaseInventory(productId: string, quantity: number): void;
+    addDiscount(input: DiscountInput): Discount;
+    getDiscount(code: string): Discount | undefined;
+    isDiscountValid(code: string, subtotal: number): boolean;
+    useDiscount(code: string): void;
+    /** Create a new shopping cart */
+    createCart(): RotateCart;
+    /**
+     * Create payment links for every active product in the catalog.
+     * Useful for generating a "Buy Now" link per product upfront.
+     * Processes sequentially to respect Solana transaction ordering.
+     */
+    createLinksForAllProducts(options?: {
+        expiresIn?: number;
+        productIds?: string[];
+        concurrency?: number;
+    }): Promise<BatchLinkResult[]>;
+    /** Export the full catalog as JSON (for persistence / API) */
+    exportCatalog(): {
+        products: Product[];
+        discounts: Discount[];
+    };
+    /** Import a catalog from JSON */
+    importCatalog(data: {
+        products: Product[];
+        discounts?: Discount[];
+    }): void;
+}
+export declare class RotateCart {
+    private store;
+    private sdk;
+    private config;
+    private items;
+    private appliedDiscounts;
+    private _metadata;
+    /** @internal */
+    constructor(store: RotateStore, sdk: RotateSDK, config: Required<StoreConfig>);
+    /** Add a product to the cart */
+    addItem(productId: string, quantity?: number): LineItem;
+    /** Set exact quantity for a product */
+    setItemQuantity(productId: string, quantity: number): LineItem | null;
+    /** Remove a product from the cart entirely */
+    removeItem(productId: string): boolean;
+    /** Clear all items */
+    clear(): void;
+    /** Get all line items */
+    getItems(): LineItem[];
+    /** Check if cart is empty */
+    get isEmpty(): boolean;
+    /** Apply a discount code */
+    applyDiscount(code: string): boolean;
+    /** Remove a discount code */
+    removeDiscount(code: string): boolean;
+    /** Attach metadata to the order (customer email, shipping address, notes, etc.) */
+    setMetadata(key: string, value: string): void;
+    getMetadata(): Record<string, string>;
+    private calculateSubtotal;
+    private calculateDiscountAmount;
+    /** Calculate full cart totals */
+    getTotals(): CartTotals;
+    /**
+     * Finalize the cart and create an on-chain payment link.
+     * Returns everything needed to present the payment to the buyer.
+     */
+    checkout(options?: {
+        /** Override expiration (seconds from now, 0 = no expiry) */
+        expiresIn?: number;
+        /** Override currency */
+        currency?: Currency;
+        /** Override tips flag */
+        allowTips?: boolean;
+        /** Custom order reference (default: auto-generated) */
+        orderRef?: string;
+        /** Custom description (default: auto-generated from cart items) */
+        description?: string;
+    }): Promise<CheckoutResult>;
+}
+export default RotateStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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