@gatewayfm/ups-sdk 0.1.13

package/dist/index-Csrh5-dl.d.ts

@@ -0,0 +1,160 @@
+interface UPSConfig {
+    baseUrl: string;
+    network: string;
+    chainId?: number;
+    timeout?: number;
+    retryAttempts?: number;
+    refreshInterval?: number;
+}
+interface AuthState {
+    isAuthenticated: boolean;
+    token: string | null;
+    expiresAt: Date | null;
+    address: string | null;
+}
+interface AuthResult {
+    token: string;
+    expiresAt: string;
+}
+interface User {
+    id: string;
+    walletAddress: string;
+    status: string;
+    createdAt: string;
+}
+interface ConnectResult {
+    user: User;
+    token: string;
+    expiresAt: string;
+    isNewUser: boolean;
+}
+type EIP1193Provider = {
+    request: (args: {
+        method: string;
+        params?: unknown[];
+    }) => Promise<unknown>;
+    on?: (event: string, handler: (...args: any[]) => void) => void;
+    removeListener?: (event: string, handler: (...args: any[]) => void) => void;
+};
+interface WalletState {
+    isConnected: boolean;
+    address: string | null;
+    chainId: number | null;
+    provider: EIP1193Provider | null;
+}
+interface ConnectedWallet {
+    address: string;
+    chainId: number;
+    provider: EIP1193Provider;
+}
+type AccountStatus = 'pending' | 'kyc_in_progress' | 'active' | 'frozen' | 'closed';
+interface Account {
+    id: string;
+    ownerAddress: string;
+    walletAddress: string;
+    status: AccountStatus;
+    kycLevel: number;
+    userId?: string;
+    createdAt: string;
+    updatedAt?: string;
+}
+interface CreateAccountParams {
+    ownerAddress: string;
+    salt: string;
+}
+interface CreateAccountResponse {
+    account: Account;
+    txHash: string;
+}
+interface PaymentRequirements {
+    scheme: string;
+    network: string;
+    maxAmountRequired: string;
+    asset: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    resource?: string;
+    description?: string;
+    extra?: PaymentExtra;
+    from?: string;
+}
+declare enum PaymentType {
+    UNSPECIFIED = "UNSPECIFIED",
+    DIRECT = "DIRECT",
+    ESCROW = "ESCROW"
+}
+interface PaymentExtra {
+    name?: string;
+    version?: string;
+    payment_type?: PaymentType;
+    arbiter?: string;
+    release_time?: number;
+    payee?: string;
+}
+interface PaymentAuthorization {
+    from: string;
+    to: string;
+    value: string;
+    validAfter: number;
+    validBefore: number;
+    nonce: string;
+}
+interface SignedAuthorization extends PaymentAuthorization {
+    signature: string;
+}
+interface VerifyResponse {
+    isValid: boolean;
+    invalidReason?: string;
+    payer?: string;
+}
+interface SettleResponse {
+    success: boolean;
+    errorReason?: string;
+    transaction?: string;
+    network?: string;
+    payer?: string;
+}
+interface SupportedScheme {
+    x402Version: number;
+    scheme: string;
+    network: string;
+}
+interface SupportedSchemesResponse {
+    kinds: SupportedScheme[];
+    extensions?: string[];
+    signers?: Record<string, string[]>;
+}
+interface EIP712Domain {
+    name: string;
+    version: string;
+    chainId: number;
+    verifyingContract: string;
+}
+interface EIP712Type {
+    name: string;
+    type: string;
+}
+interface EIP712TypedData {
+    domain: EIP712Domain;
+    types: Record<string, EIP712Type[]>;
+    primaryType: string;
+    message: Record<string, unknown>;
+}
+interface Escrow {
+    escrowId: string;
+    payer: string;
+    payee: string;
+    amount: string;
+    arbiter: string;
+    releaseTime: number;
+    status: EscrowStatus;
+}
+type EscrowStatus = 'ACTIVE' | 'RELEASED' | 'REFUNDED';
+interface EscrowActionResponse {
+    success: boolean;
+    errorReason?: string;
+    transaction?: string;
+    network?: string;
+}
+
+export { type AuthState as A, type ConnectResult as C, type Escrow as E, type PaymentAuthorization as P, type SettleResponse as S, type User as U, type VerifyResponse as V, type WalletState as W, type AuthResult as a, type EscrowActionResponse as b, type UPSConfig as c, type EIP1193Provider as d, type ConnectedWallet as e, type Account as f, type AccountStatus as g, type CreateAccountParams as h, type CreateAccountResponse as i, type EIP712Domain as j, type EIP712Type as k, type EIP712TypedData as l, type EscrowStatus as m, type PaymentExtra as n, type PaymentRequirements as o, PaymentType as p, type SignedAuthorization as q, type SupportedScheme as r, type SupportedSchemesResponse as s };

package/dist/index-D_ytPgEV.d.ts

@@ -0,0 +1,35 @@
+import { W as WalletState, d as EIP1193Provider, e as ConnectedWallet, l as EIP712TypedData } from './index-Csrh5-dl.js';
+
+type Callback<T = any> = (payload: T) => void;
+type Unsubscribe = () => void;
+declare class EventBus {
+    private listeners;
+    emit<T>(event: string, payload: T): void;
+    on<T>(event: string, callback: Callback<T>): Unsubscribe;
+    once<T>(event: string, callback: Callback<T>): Unsubscribe;
+    off(event: string, callback: Callback): void;
+    clear(): void;
+}
+
+declare class WalletModule {
+    private eventBus;
+    private _state;
+    private client;
+    private chains;
+    constructor(eventBus: EventBus);
+    get state(): WalletState;
+    connect(provider: EIP1193Provider): Promise<ConnectedWallet>;
+    disconnect(): Promise<void>;
+    getAddress(): string | null;
+    getChainId(): number | null;
+    isConnected(): boolean;
+    signMessage(message: string): Promise<string>;
+    signTypedData(typedData: EIP712TypedData): Promise<string>;
+    switchChain(chainId: number): Promise<void>;
+    onStateChange(callback: (state: WalletState) => void): () => void;
+    private updateState;
+    private setupListeners;
+    private getChain;
+}
+
+export { EventBus as E, WalletModule as W };

package/dist/index.d.mts

@@ -0,0 +1,130 @@
+import { A as AuthState, C as ConnectResult, a as AuthResult, E as Escrow, b as EscrowActionResponse, U as User, c as UPSConfig, d as EIP1193Provider, e as ConnectedWallet } from './index-Csrh5-dl.mjs';
+export { f as Account, g as AccountStatus, h as CreateAccountParams, i as CreateAccountResponse, j as EIP712Domain, k as EIP712Type, l as EIP712TypedData, m as EscrowStatus, P as PaymentAuthorization, n as PaymentExtra, o as PaymentRequirements, p as PaymentType, S as SettleResponse, q as SignedAuthorization, r as SupportedScheme, s as SupportedSchemesResponse, V as VerifyResponse, W as WalletState } from './index-Csrh5-dl.mjs';
+import { H as HttpClient } from './http-client-D9JtkvUx.mjs';
+import { E as EventBus, W as WalletModule } from './index-1p5DSytk.mjs';
+import { AccountModule } from './account/index.mjs';
+import { PaymentModule } from './payment/index.mjs';
+
+declare class UPSError extends Error {
+    code: string;
+    details?: unknown;
+    constructor(message: string, code: string, details?: unknown);
+}
+declare class NetworkError extends UPSError {
+    status?: number;
+    constructor(message: string, details?: unknown, status?: number);
+}
+declare class AuthError extends UPSError {
+    constructor(message: string, details?: unknown);
+}
+declare class WalletError extends UPSError {
+    constructor(message: string, details?: unknown);
+}
+declare class PaymentError extends UPSError {
+    constructor(message: string, details?: unknown);
+}
+declare class RateLimitError extends UPSError {
+    constructor(message: string, details?: unknown);
+}
+
+declare class AuthManager {
+    private http;
+    private eventBus;
+    private _state;
+    private refreshTimer;
+    private refreshInterval;
+    constructor(http: HttpClient, eventBus: EventBus, refreshInterval?: number);
+    get state(): AuthState;
+    /**
+     * Unified connect method - creates user if new, authenticates if existing
+     * This is the preferred authentication method.
+     */
+    connect(walletAddress: string, message: string, signature: string): Promise<ConnectResult>;
+    /**
+     * @deprecated Use connect() instead
+     */
+    login(walletAddress: string, message: string, signature: string): Promise<AuthResult>;
+    /**
+     * @deprecated Use connect() instead
+     */
+    register(walletAddress: string, message: string, signature: string): Promise<AuthResult>;
+    private handleAuthSuccess;
+    refresh(): Promise<void>;
+    private mapUser;
+    logout(): void;
+    getToken(): string | null;
+    isAuthenticated(): boolean;
+    onStateChange(callback: (state: AuthState) => void): () => void;
+    private updateState;
+    private scheduleRefresh;
+}
+
+declare class EscrowModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get escrow details by ID
+     * @param escrowId Escrow ID
+     */
+    get(escrowId: string): Promise<Escrow>;
+    /**
+     * Release escrow funds (Payer or Arbiter only)
+     * @param escrowId Escrow ID
+     */
+    release(escrowId: string, network: string): Promise<EscrowActionResponse>;
+    /**
+     * Refund escrow funds (Arbiter only)
+     * @param escrowId Escrow ID
+     */
+    refund(escrowId: string, network: string): Promise<EscrowActionResponse>;
+}
+
+/**
+ * UserModule provides access to user profile operations.
+ *
+ * @example
+ * ```typescript
+ * const user = await client.user.getCurrentUser();
+ * console.log(user.id, user.walletAddress);
+ * ```
+ */
+declare class UserModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get the current authenticated user's profile.
+     * Requires authentication.
+     */
+    getCurrentUser(): Promise<User>;
+    private mapUser;
+}
+
+declare class UPSClient {
+    readonly config: UPSConfig;
+    readonly wallet: WalletModule;
+    readonly auth: AuthManager;
+    readonly account: AccountModule;
+    readonly payment: PaymentModule;
+    readonly escrow: EscrowModule;
+    readonly user: UserModule;
+    private http;
+    private eventBus;
+    constructor(config: UPSConfig);
+    connect(provider: EIP1193Provider): Promise<ConnectedWallet>;
+    /**
+     * Authenticate with the UPS backend using the unified /auth/connect endpoint.
+     * This will create a new user if one doesn't exist, or authenticate an existing user.
+     *
+     * @returns ConnectResult containing user info and whether this is a new user
+     */
+    authenticate(): Promise<ConnectResult>;
+    /**
+     * @deprecated Use authenticate() instead which uses the unified /auth/connect endpoint.
+     * This method uses the legacy login/register flow.
+     */
+    authenticateLegacy(): Promise<void>;
+    disconnect(): Promise<void>;
+    destroy(): void;
+}
+
+export { AccountModule, AuthError, AuthManager, AuthResult, AuthState, ConnectResult, ConnectedWallet, EIP1193Provider, Escrow, EscrowActionResponse, EscrowModule, EventBus, HttpClient, NetworkError, PaymentError, PaymentModule, RateLimitError, UPSClient, UPSConfig, UPSError, User, UserModule, WalletError, WalletModule };

package/dist/index.d.ts

@@ -0,0 +1,130 @@
+import { A as AuthState, C as ConnectResult, a as AuthResult, E as Escrow, b as EscrowActionResponse, U as User, c as UPSConfig, d as EIP1193Provider, e as ConnectedWallet } from './index-Csrh5-dl.js';
+export { f as Account, g as AccountStatus, h as CreateAccountParams, i as CreateAccountResponse, j as EIP712Domain, k as EIP712Type, l as EIP712TypedData, m as EscrowStatus, P as PaymentAuthorization, n as PaymentExtra, o as PaymentRequirements, p as PaymentType, S as SettleResponse, q as SignedAuthorization, r as SupportedScheme, s as SupportedSchemesResponse, V as VerifyResponse, W as WalletState } from './index-Csrh5-dl.js';
+import { H as HttpClient } from './http-client-D9JtkvUx.js';
+import { E as EventBus, W as WalletModule } from './index-D_ytPgEV.js';
+import { AccountModule } from './account/index.js';
+import { PaymentModule } from './payment/index.js';
+
+declare class UPSError extends Error {
+    code: string;
+    details?: unknown;
+    constructor(message: string, code: string, details?: unknown);
+}
+declare class NetworkError extends UPSError {
+    status?: number;
+    constructor(message: string, details?: unknown, status?: number);
+}
+declare class AuthError extends UPSError {
+    constructor(message: string, details?: unknown);
+}
+declare class WalletError extends UPSError {
+    constructor(message: string, details?: unknown);
+}
+declare class PaymentError extends UPSError {
+    constructor(message: string, details?: unknown);
+}
+declare class RateLimitError extends UPSError {
+    constructor(message: string, details?: unknown);
+}
+
+declare class AuthManager {
+    private http;
+    private eventBus;
+    private _state;
+    private refreshTimer;
+    private refreshInterval;
+    constructor(http: HttpClient, eventBus: EventBus, refreshInterval?: number);
+    get state(): AuthState;
+    /**
+     * Unified connect method - creates user if new, authenticates if existing
+     * This is the preferred authentication method.
+     */
+    connect(walletAddress: string, message: string, signature: string): Promise<ConnectResult>;
+    /**
+     * @deprecated Use connect() instead
+     */
+    login(walletAddress: string, message: string, signature: string): Promise<AuthResult>;
+    /**
+     * @deprecated Use connect() instead
+     */
+    register(walletAddress: string, message: string, signature: string): Promise<AuthResult>;
+    private handleAuthSuccess;
+    refresh(): Promise<void>;
+    private mapUser;
+    logout(): void;
+    getToken(): string | null;
+    isAuthenticated(): boolean;
+    onStateChange(callback: (state: AuthState) => void): () => void;
+    private updateState;
+    private scheduleRefresh;
+}
+
+declare class EscrowModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get escrow details by ID
+     * @param escrowId Escrow ID
+     */
+    get(escrowId: string): Promise<Escrow>;
+    /**
+     * Release escrow funds (Payer or Arbiter only)
+     * @param escrowId Escrow ID
+     */
+    release(escrowId: string, network: string): Promise<EscrowActionResponse>;
+    /**
+     * Refund escrow funds (Arbiter only)
+     * @param escrowId Escrow ID
+     */
+    refund(escrowId: string, network: string): Promise<EscrowActionResponse>;
+}
+
+/**
+ * UserModule provides access to user profile operations.
+ *
+ * @example
+ * ```typescript
+ * const user = await client.user.getCurrentUser();
+ * console.log(user.id, user.walletAddress);
+ * ```
+ */
+declare class UserModule {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * Get the current authenticated user's profile.
+     * Requires authentication.
+     */
+    getCurrentUser(): Promise<User>;
+    private mapUser;
+}
+
+declare class UPSClient {
+    readonly config: UPSConfig;
+    readonly wallet: WalletModule;
+    readonly auth: AuthManager;
+    readonly account: AccountModule;
+    readonly payment: PaymentModule;
+    readonly escrow: EscrowModule;
+    readonly user: UserModule;
+    private http;
+    private eventBus;
+    constructor(config: UPSConfig);
+    connect(provider: EIP1193Provider): Promise<ConnectedWallet>;
+    /**
+     * Authenticate with the UPS backend using the unified /auth/connect endpoint.
+     * This will create a new user if one doesn't exist, or authenticate an existing user.
+     *
+     * @returns ConnectResult containing user info and whether this is a new user
+     */
+    authenticate(): Promise<ConnectResult>;
+    /**
+     * @deprecated Use authenticate() instead which uses the unified /auth/connect endpoint.
+     * This method uses the legacy login/register flow.
+     */
+    authenticateLegacy(): Promise<void>;
+    disconnect(): Promise<void>;
+    destroy(): void;
+}
+
+export { AccountModule, AuthError, AuthManager, AuthResult, AuthState, ConnectResult, ConnectedWallet, EIP1193Provider, Escrow, EscrowActionResponse, EscrowModule, EventBus, HttpClient, NetworkError, PaymentError, PaymentModule, RateLimitError, UPSClient, UPSConfig, UPSError, User, UserModule, WalletError, WalletModule };