@rozoai/intent-common 0.0.28-beta.2 → 0.0.28-beta.3

package/dist/api/base.d.ts

@@ -0,0 +1,90 @@
+/**
+ * RozoAI API Configuration Constants
+ */
+export declare const ROZO_API_URL = "https://intentapiv2.rozo.ai/functions/v1";
+export declare const ROZO_API_TOKEN = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZ4Y3Zmb2xobmNtdXZmYXp1cXViIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTI4Mzg2NjYsImV4cCI6MjA2ODQxNDY2Nn0.B4dV5y_-zCMKSNm3_qyCbAvCPJmoOGv_xB783LfAVUA";
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+export interface RequestOptions {
+    method?: HttpMethod;
+    headers?: Record<string, string>;
+    body?: any;
+    params?: Record<string, string>;
+    signal?: AbortSignal;
+}
+export interface ApiResponse<T = any> {
+    data: T | null;
+    error: Error | null;
+    status: number | null;
+}
+export interface RequestState<T = any> extends ApiResponse<T> {
+    isLoading: boolean;
+    isError: boolean;
+    isSuccess: boolean;
+}
+/**
+ * API Configuration
+ */
+export interface ApiConfig {
+    baseUrl: string;
+    apiToken: string;
+}
+/**
+ * Set API configuration
+ * @param config - API configuration
+ */
+export declare const setApiConfig: (config: Partial<ApiConfig>) => void;
+/**
+ * Get current API configuration
+ * @returns Current API configuration
+ */
+export declare const getApiConfig: () => ApiConfig;
+/**
+ * Core fetch function for making API requests
+ * @param url - API endpoint path
+ * @param options - Request options
+ * @returns Promise with response data
+ */
+export declare const fetchApi: <T = any>(url: string, options?: RequestOptions) => Promise<ApiResponse<T>>;
+/**
+ * API client with methods for different HTTP verbs
+ */
+export declare const apiClient: {
+    /**
+     * GET request
+     * @param url - API endpoint path
+     * @param options - Request options
+     * @returns Promise with response data
+     */
+    get: <T = any>(url: string, options?: Omit<RequestOptions, "method" | "body">) => Promise<ApiResponse<T>>;
+    /**
+     * POST request
+     * @param url - API endpoint path
+     * @param body - Request body
+     * @param options - Additional request options
+     * @returns Promise with response data
+     */
+    post: <T = any>(url: string, body: any, options?: Omit<RequestOptions, "method" | "body">) => Promise<ApiResponse<T>>;
+    /**
+     * PUT request
+     * @param url - API endpoint path
+     * @param body - Request body
+     * @param options - Additional request options
+     * @returns Promise with response data
+     */
+    put: <T = any>(url: string, body: any, options?: Omit<RequestOptions, "method" | "body">) => Promise<ApiResponse<T>>;
+    /**
+     * PATCH request
+     * @param url - API endpoint path
+     * @param body - Request body
+     * @param options - Additional request options
+     * @returns Promise with response data
+     */
+    patch: <T = any>(url: string, body: any, options?: Omit<RequestOptions, "method" | "body">) => Promise<ApiResponse<T>>;
+    /**
+     * DELETE request
+     * @param url - API endpoint path
+     * @param options - Request options
+     * @returns Promise with response data
+     */
+    delete: <T = any>(url: string, options?: Omit<RequestOptions, "method">) => Promise<ApiResponse<T>>;
+};

package/dist/api/base.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiClient = exports.fetchApi = exports.getApiConfig = exports.setApiConfig = exports.ROZO_API_TOKEN = exports.ROZO_API_URL = void 0;
+/**
+ * RozoAI API Configuration Constants
+ */
+exports.ROZO_API_URL = "https://intentapiv2.rozo.ai/functions/v1";
+exports.ROZO_API_TOKEN = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZ4Y3Zmb2xobmNtdXZmYXp1cXViIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTI4Mzg2NjYsImV4cCI6MjA2ODQxNDY2Nn0.B4dV5y_-zCMKSNm3_qyCbAvCPJmoOGv_xB783LfAVUA";
+// Default configuration (can be overridden via setApiConfig)
+let apiConfig = {
+    baseUrl: exports.ROZO_API_URL,
+    apiToken: exports.ROZO_API_TOKEN,
+};
+/**
+ * Set API configuration
+ * @param config - API configuration
+ */
+const setApiConfig = (config) => {
+    apiConfig = { ...apiConfig, ...config };
+};
+exports.setApiConfig = setApiConfig;
+/**
+ * Get current API configuration
+ * @returns Current API configuration
+ */
+const getApiConfig = () => {
+    return apiConfig;
+};
+exports.getApiConfig = getApiConfig;
+/**
+ * Creates a URL with query parameters
+ * @param url - Base URL
+ * @param params - Query parameters
+ * @returns Full URL with query parameters
+ */
+const createUrl = (url, params) => {
+    const fullUrl = url.startsWith("/")
+        ? `${apiConfig.baseUrl}${url}`
+        : `${apiConfig.baseUrl}/${url}`;
+    if (!params)
+        return fullUrl;
+    const queryParams = new URLSearchParams();
+    Object.entries(params).forEach(([key, value]) => {
+        if (value !== undefined && value !== null) {
+            queryParams.append(key, value);
+        }
+    });
+    const queryString = queryParams.toString();
+    return queryString ? `${fullUrl}?${queryString}` : fullUrl;
+};
+/**
+ * Core fetch function for making API requests
+ * @param url - API endpoint path
+ * @param options - Request options
+ * @returns Promise with response data
+ */
+const fetchApi = async (url, options = {}) => {
+    const { method = "GET", headers = {}, body, params, signal } = options;
+    try {
+        const fullUrl = createUrl(url, params);
+        const requestHeaders = {
+            "Content-Type": "application/json",
+            ...headers,
+            Authorization: `Bearer ${apiConfig.apiToken}`,
+        };
+        const requestOptions = {
+            method,
+            headers: requestHeaders,
+            signal,
+        };
+        if (body && method !== "GET") {
+            requestOptions.body = JSON.stringify(body);
+        }
+        const response = await fetch(fullUrl, requestOptions);
+        const status = response.status;
+        // Handle non-JSON responses
+        const contentType = response.headers.get("content-type");
+        let data = null;
+        if (contentType && contentType.includes("application/json")) {
+            data = (await response.json());
+        }
+        else if (contentType && contentType.includes("text/")) {
+            data = (await response.text());
+        }
+        if (!response.ok) {
+            throw new Error(data ? JSON.stringify(data) : response.statusText);
+        }
+        return { data, error: null, status };
+    }
+    catch (error) {
+        return {
+            data: null,
+            error: error instanceof Error ? error : new Error(String(error)),
+            status: null,
+        };
+    }
+};
+exports.fetchApi = fetchApi;
+/**
+ * API client with methods for different HTTP verbs
+ */
+exports.apiClient = {
+    /**
+     * GET request
+     * @param url - API endpoint path
+     * @param options - Request options
+     * @returns Promise with response data
+     */
+    get: (url, options = {}) => (0, exports.fetchApi)(url, { ...options, method: "GET" }),
+    /**
+     * POST request
+     * @param url - API endpoint path
+     * @param body - Request body
+     * @param options - Additional request options
+     * @returns Promise with response data
+     */
+    post: (url, body, options = {}) => (0, exports.fetchApi)(url, { ...options, method: "POST", body }),
+    /**
+     * PUT request
+     * @param url - API endpoint path
+     * @param body - Request body
+     * @param options - Additional request options
+     * @returns Promise with response data
+     */
+    put: (url, body, options = {}) => (0, exports.fetchApi)(url, { ...options, method: "PUT", body }),
+    /**
+     * PATCH request
+     * @param url - API endpoint path
+     * @param body - Request body
+     * @param options - Additional request options
+     * @returns Promise with response data
+     */
+    patch: (url, body, options = {}) => (0, exports.fetchApi)(url, { ...options, method: "PATCH", body }),
+    /**
+     * DELETE request
+     * @param url - API endpoint path
+     * @param options - Request options
+     * @returns Promise with response data
+     */
+    delete: (url, options = {}) => (0, exports.fetchApi)(url, { ...options, method: "DELETE" }),
+};
+//# sourceMappingURL=base.js.map

package/dist/api/base.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * API client utilities for RozoAI Intent Pay
+ *
+ * This module provides core API client functionality for making HTTP requests
+ * to the RozoAI payment API. It includes:
+ * - Base API client with support for GET, POST, PUT, PATCH, DELETE
+ * - Payment API functions and types
+ * - Type-safe interfaces for requests and responses
+ *
+ * Note: React hooks for these APIs are available in the @rozoai/intent-pay package.
+ */
+export * from "./base";
+export * from "./payment";

package/dist/api/index.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * API client utilities for RozoAI Intent Pay
+ *
+ * This module provides core API client functionality for making HTTP requests
+ * to the RozoAI payment API. It includes:
+ * - Base API client with support for GET, POST, PUT, PATCH, DELETE
+ * - Payment API functions and types
+ * - Type-safe interfaces for requests and responses
+ *
+ * Note: React hooks for these APIs are available in the @rozoai/intent-pay package.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base"), exports);
+__exportStar(require("./payment"), exports);
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;AAEH,yCAAuB;AACvB,4CAA0B"}

package/dist/api/payment.d.ts

@@ -0,0 +1,93 @@
+import { ApiResponse } from "./base";
+/**
+ * Payment display information
+ */
+export interface PaymentDisplay {
+    intent: string;
+    paymentValue: string;
+    currency: string;
+}
+/**
+ * Payment destination information
+ */
+export interface PaymentDestination {
+    destinationAddress?: string;
+    chainId: string;
+    amountUnits: string;
+    tokenSymbol: string;
+    tokenAddress?: string;
+    txHash?: string | null;
+}
+/**
+ * Payment source information
+ */
+export interface PaymentSource {
+    sourceAddress?: string;
+    [key: string]: unknown;
+}
+/**
+ * Payment request data type
+ */
+export interface PaymentRequestData {
+    appId: string;
+    display: PaymentDisplay;
+    destination: PaymentDestination;
+    externalId?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Payment response data type
+ */
+export interface PaymentResponseData {
+    id: string;
+    status: "payment_unpaid" | string;
+    createdAt: string;
+    display: {
+        intent: string;
+        currency: string;
+        paymentValue?: string;
+    };
+    source: PaymentSource | null;
+    destination: {
+        destinationAddress: string;
+        txHash: string | null;
+        chainId: string;
+        amountUnits: string;
+        tokenSymbol: string;
+        tokenAddress: string;
+    };
+    metadata: {
+        daimoOrderId?: string;
+        intent: string;
+        items: unknown[];
+        payer: Record<string, unknown>;
+        appId: string;
+        orderDate: string;
+        webhookUrl: string;
+        provider: string;
+        receivingAddress: string;
+        memo: string | null;
+        payinchainid: string;
+        payintokenaddress: string;
+        preferredChain: string;
+        preferredToken: string;
+        preferredTokenAddress: string;
+        source_tx_hash?: string;
+        [key: string]: unknown;
+    };
+    url: string;
+    [key: string]: unknown;
+}
+/**
+ * Creates a new payment
+ * @param paymentData - Payment data to send
+ * @returns Promise with payment response
+ */
+export declare const createRozoPayment: (paymentData: PaymentRequestData) => Promise<ApiResponse<PaymentResponseData>>;
+/**
+ * Gets payment details by ID
+ * @param paymentId - Payment ID
+ * @returns Promise with payment response
+ */
+export declare const getRozoPayment: (paymentId: string) => Promise<ApiResponse<PaymentResponseData>>;

package/dist/api/payment.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRozoPayment = exports.createRozoPayment = void 0;
+const base_1 = require("./base");
+/**
+ * Creates a new payment
+ * @param paymentData - Payment data to send
+ * @returns Promise with payment response
+ */
+const createRozoPayment = (paymentData) => {
+    return base_1.apiClient.post("/payment-api", paymentData);
+};
+exports.createRozoPayment = createRozoPayment;
+/**
+ * Gets payment details by ID
+ * @param paymentId - Payment ID
+ * @returns Promise with payment response
+ */
+const getRozoPayment = (paymentId) => {
+    const isMugglePay = paymentId.includes("mugglepay_order");
+    const endpoint = isMugglePay
+        ? `payment-api/${paymentId}`
+        : `payment/id/${paymentId}`;
+    return base_1.apiClient.get(endpoint);
+};
+exports.getRozoPayment = getRozoPayment;
+//# sourceMappingURL=payment.js.map

package/dist/api/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/api/payment.ts"],"names":[],"mappings":";;;AAAA,iCAAgD;AAuFhD;;;;GAIG;AACI,MAAM,iBAAiB,GAAG,CAC/B,WAA+B,EACY,EAAE;IAC7C,OAAO,gBAAS,CAAC,IAAI,CAAsB,cAAc,EAAE,WAAW,CAAC,CAAC;AAC1E,CAAC,CAAC;AAJW,QAAA,iBAAiB,qBAI5B;AAEF;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAC5B,SAAiB,EAC0B,EAAE;IAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,WAAW;QAC1B,CAAC,CAAC,eAAe,SAAS,EAAE;QAC5B,CAAC,CAAC,cAAc,SAAS,EAAE,CAAC;IAC9B,OAAO,gBAAS,CAAC,GAAG,CAAsB,QAAQ,CAAC,CAAC;AACtD,CAAC,CAAC;AARW,QAAA,cAAc,kBAQzB"}

package/dist/bridge.d.ts

@@ -0,0 +1,164 @@
+import { RozoPayHydratedOrderWithOrg } from ".";
+import type { PaymentResponseData } from "./api";
+export interface PaymentBridgeConfig {
+    toChain?: number;
+    toToken?: string;
+    toAddress?: string;
+    toStellarAddress?: string;
+    toSolanaAddress?: string;
+    toUnits: string;
+    payInTokenAddress: string;
+    log?: (msg: string) => void;
+}
+export interface PreferredPaymentConfig {
+    preferredChain: string;
+    preferredToken: "USDC" | "USDT" | "XLM";
+    preferredTokenAddress?: string;
+}
+export interface DestinationConfig {
+    destinationAddress?: string;
+    chainId: string;
+    amountUnits: string;
+    tokenSymbol: string;
+    tokenAddress: string;
+}
+/**
+ * Creates payment bridge configuration for cross-chain payment routing
+ *
+ * Determines the optimal payment routing based on the destination chain/token
+ * and the wallet payment option selected by the user. This function handles
+ * the complexity of multi-chain payments by:
+ *
+ * 1. **Preferred Payment Method**: Identifies which chain/token the user will pay from
+ *    - Supports Base USDC, Polygon USDC, Solana USDC, Stellar USDC, and BSC USDT
+ *    - Sets appropriate chain ID and token address for the source transaction
+ *
+ * 2. **Destination Configuration**: Determines where funds will be received
+ *    - Supports Base, Solana, and Stellar as destination chains
+ *    - Handles special address formats for Solana and Stellar addresses
+ *    - Defaults to Base USDC when no special destination is specified
+ *
+ * 3. **Cross-Chain Bridging**: Configures the payment bridge parameters
+ *    - Maps user's selected wallet/token to the appropriate payment method
+ *    - Sets up destination chain and token configuration
+ *    - Handles token address formatting (e.g., Stellar's `USDC:issuerPK` format)
+ *
+ * @param config - Payment bridge configuration parameters
+ * @param config.toChain - Destination chain ID (defaults to Base: 8453)
+ * @param config.toToken - Destination token address (defaults to Base USDC)
+ * @param config.toAddress - Standard EVM destination address
+ * @param config.toStellarAddress - Stellar-specific destination address (if paying to Stellar)
+ * @param config.toSolanaAddress - Solana-specific destination address (if paying to Solana)
+ * @param config.toUnits - Amount in token units (smallest denomination)
+ * @param config.payInTokenAddress - Token address user selected to pay with
+ * @param config.log - Optional logging function for debugging
+ *
+ * @returns Payment routing configuration
+ * @returns preferred - Source payment configuration (chain, token user will pay from)
+ * @returns destination - Destination payment configuration (chain, token user will receive)
+ *
+ * @example
+ * ```typescript
+ * // User wants to pay with Polygon USDC to receive on Base
+ * const { preferred, destination } = createPaymentBridgeConfig({
+ *   toChain: 8453, // Base
+ *   toToken: baseUSDC.token,
+ *   toAddress: '0x123...',
+ *   toUnits: '1000000', // 1 USDC
+ *   payInTokenAddress: polygonUSDC.token,
+ *   log: console.log
+ * });
+ *
+ * // preferred = { preferredChain: '137', preferredToken: 'USDC', preferredTokenAddress: '0x2791...' }
+ * // destination = { destinationAddress: '0x123...', chainId: '8453', amountUnits: '1000000', ... }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // User wants to pay to a Stellar address
+ * const { preferred, destination } = createPaymentBridgeConfig({
+ *   toStellarAddress: 'GDZS...',
+ *   toUnits: '1000000',
+ *   payInTokenAddress: baseUSDC.token,
+ * });
+ *
+ * // destination will be configured for Stellar chain with USDC:issuerPK format
+ * ```
+ *
+ * @note Currently only supports Base USDC and Stellar USDC as destination chains.
+ *       Support for additional destination chains is planned.
+ *
+ * @see PreferredPaymentConfig
+ * @see DestinationConfig
+ */
+export declare function createPaymentBridgeConfig({ toChain, toToken, toAddress, toStellarAddress, toSolanaAddress, toUnits, payInTokenAddress, log, }: PaymentBridgeConfig): {
+    preferred: PreferredPaymentConfig;
+    destination: DestinationConfig;
+};
+/**
+ * Transforms a payment API response into a fully hydrated order object
+ *
+ * Converts the payment response data from the RozoAI payment API into a complete
+ * `RozoPayHydratedOrderWithOrg` object that contains all the information needed
+ * to display order status, track payments, and handle cross-chain transactions.
+ *
+ * This function performs several key transformations:
+ *
+ * 1. **Token Resolution**: Identifies the correct token based on chain and address
+ *    - Uses `getKnownToken()` to resolve token metadata (decimals, symbol, logo, etc.)
+ *    - Handles special cases for Stellar tokens using issuer public key
+ *
+ * 2. **Order Structure**: Creates a complete order with all required fields
+ *    - Generates random order ID for internal tracking
+ *    - Sets up intent, handoff, and contract addresses
+ *    - Configures bridge token options and destination amounts
+ *
+ * 3. **Status Initialization**: Sets initial payment statuses
+ *    - Source status: WAITING_PAYMENT (awaiting user transaction)
+ *    - Destination status: PENDING (not yet received)
+ *    - Intent status: UNPAID (payment not initiated)
+ *
+ * 4. **Metadata Merge**: Combines various metadata sources
+ *    - Merges order metadata, user metadata, and custom metadata
+ *    - Preserves external ID and organization information
+ *
+ * @param order - Payment response data from the RozoAI payment API
+ * @param order.metadata - Payment metadata including chain, token, and routing info
+ * @param order.destination - Destination configuration (chain, token, amount, address)
+ * @param order.source - Source transaction info (if payment has been initiated)
+ * @param order.orgId - Organization ID for the payment
+ * @param order.externalId - External reference ID (if provided by merchant)
+ *
+ * @returns Complete hydrated order object with all payment tracking information
+ * @returns id - Unique order identifier (random BigInt)
+ * @returns mode - Order mode (HYDRATED)
+ * @returns sourceStatus - Source transaction status
+ * @returns destStatus - Destination transaction status
+ * @returns intentStatus - Overall payment intent status
+ * @returns metadata - Merged metadata from all sources
+ * @returns org - Organization information
+ *
+ * @example
+ * ```typescript
+ * const paymentResponse = await getRozoPayment(paymentId);
+ *
+ * const hydratedOrder = formatPaymentResponseDataToHydratedOrder(
+ *   paymentResponse.data,
+ *   'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN'
+ * );
+ *
+ * console.log(hydratedOrder.sourceStatus); // 'WAITING_PAYMENT'
+ * console.log(hydratedOrder.destFinalCallTokenAmount.token.symbol); // 'USDC'
+ * console.log(hydratedOrder.usdValue); // 10.00
+ * ```
+ *
+ * @note The generated order ID is random and intended for client-side tracking only.
+ *       Use `externalId` or the API payment ID for server-side reference.
+ *
+ * @note The function sets a 5-minute expiration timestamp from the current time.
+ *
+ * @see PaymentResponseData
+ * @see RozoPayHydratedOrderWithOrg
+ * @see getKnownToken
+ */
+export declare function formatResponseToHydratedOrder(order: PaymentResponseData): RozoPayHydratedOrderWithOrg;