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

package/src/api/base.ts

@@ -0,0 +1,215 @@
+/**
+ * RozoAI API Configuration Constants
+ */
+export const ROZO_API_URL = "https://intentapiv2.rozo.ai/functions/v1";
+export const ROZO_API_TOKEN =
+  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZ4Y3Zmb2xobmNtdXZmYXp1cXViIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTI4Mzg2NjYsImV4cCI6MjA2ODQxNDY2Nn0.B4dV5y_-zCMKSNm3_qyCbAvCPJmoOGv_xB783LfAVUA";
+
+// HTTP methods type
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+
+// Request options type
+export interface RequestOptions {
+  method?: HttpMethod;
+  headers?: Record<string, string>;
+  body?: any;
+  params?: Record<string, string>;
+  signal?: AbortSignal;
+}
+
+// Response type with generic data
+export interface ApiResponse<T = any> {
+  data: T | null;
+  error: Error | null;
+  status: number | null;
+}
+
+// Request state for hooks (used in connectkit)
+export interface RequestState<T = any> extends ApiResponse<T> {
+  isLoading: boolean;
+  isError: boolean;
+  isSuccess: boolean;
+}
+
+/**
+ * API Configuration
+ */
+export interface ApiConfig {
+  baseUrl: string;
+  apiToken: string;
+}
+
+// Default configuration (can be overridden via setApiConfig)
+let apiConfig: ApiConfig = {
+  baseUrl: ROZO_API_URL,
+  apiToken: ROZO_API_TOKEN,
+};
+
+/**
+ * Set API configuration
+ * @param config - API configuration
+ */
+export const setApiConfig = (config: Partial<ApiConfig>) => {
+  apiConfig = { ...apiConfig, ...config };
+};
+
+/**
+ * Get current API configuration
+ * @returns Current API configuration
+ */
+export const getApiConfig = (): ApiConfig => {
+  return apiConfig;
+};
+
+/**
+ * Creates a URL with query parameters
+ * @param url - Base URL
+ * @param params - Query parameters
+ * @returns Full URL with query parameters
+ */
+const createUrl = (url: string, params?: Record<string, string>): string => {
+  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
+ */
+export const fetchApi = async <T = any>(
+  url: string,
+  options: RequestOptions = {}
+): Promise<ApiResponse<T>> => {
+  const { method = "GET", headers = {}, body, params, signal } = options;
+
+  try {
+    const fullUrl = createUrl(url, params);
+
+    const requestHeaders: Record<string, string> = {
+      "Content-Type": "application/json",
+      ...headers,
+      Authorization: `Bearer ${apiConfig.apiToken}`,
+    };
+
+    const requestOptions: {
+      method: string;
+      headers: Record<string, string>;
+      signal?: AbortSignal;
+      body?: string;
+    } = {
+      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: T | null = null;
+
+    if (contentType && contentType.includes("application/json")) {
+      data = (await response.json()) as T;
+    } else if (contentType && contentType.includes("text/")) {
+      data = (await response.text()) as unknown as T;
+    }
+
+    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,
+    };
+  }
+};
+
+/**
+ * API client with methods for different HTTP verbs
+ */
+export 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"> = {}
+  ) => fetchApi<T>(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: <T = any>(
+    url: string,
+    body: any,
+    options: Omit<RequestOptions, "method" | "body"> = {}
+  ) => fetchApi<T>(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: <T = any>(
+    url: string,
+    body: any,
+    options: Omit<RequestOptions, "method" | "body"> = {}
+  ) => fetchApi<T>(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: <T = any>(
+    url: string,
+    body: any,
+    options: Omit<RequestOptions, "method" | "body"> = {}
+  ) => fetchApi<T>(url, { ...options, method: "PATCH", body }),
+
+  /**
+   * 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"> = {}
+  ) => fetchApi<T>(url, { ...options, method: "DELETE" }),
+};

package/src/api/index.ts

@@ -0,0 +1,14 @@
+/**
+ * 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/src/api/payment.ts

@@ -0,0 +1,112 @@
+import { apiClient, 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 const createRozoPayment = (
+  paymentData: PaymentRequestData
+): Promise<ApiResponse<PaymentResponseData>> => {
+  return apiClient.post<PaymentResponseData>("/payment-api", paymentData);
+};
+
+/**
+ * Gets payment details by ID
+ * @param paymentId - Payment ID
+ * @returns Promise with payment response
+ */
+export const getRozoPayment = (
+  paymentId: string
+): Promise<ApiResponse<PaymentResponseData>> => {
+  const isMugglePay = paymentId.includes("mugglepay_order");
+  const endpoint = isMugglePay
+    ? `payment-api/${paymentId}`
+    : `payment/id/${paymentId}`;
+  return apiClient.get<PaymentResponseData>(endpoint);
+};