@b3dotfun/sdk 0.1.68-alpha.3 → 0.1.68-alpha.4

package/dist/cjs/anyspend/platform/types.d.ts

@@ -0,0 +1,478 @@
+/**
+ * TypeScript types for the AnySpend Platform API.
+ */
+export interface ListResponse<T> {
+    object: "list";
+    data: T[];
+    has_more: boolean;
+    total_count: number;
+    url: string;
+}
+export interface DeletedResponse {
+    object: string;
+    id: string;
+    deleted: true;
+}
+export interface ActionResponse {
+    object: "action";
+    action: string;
+    [key: string]: unknown;
+}
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+}
+export interface PaymentLink {
+    object: "payment_link";
+    id: string;
+    short_code: string;
+    url?: string;
+    name: string;
+    description: string | null;
+    amount: string | null;
+    min_amount: string | null;
+    max_amount: string | null;
+    suggested_amount: string | null;
+    token_address: string;
+    chain_id: number;
+    recipient_address: string;
+    product_id: string | null;
+    image_url: string | null;
+    theme_color: string | null;
+    button_text: string;
+    max_uses: number | null;
+    current_uses: number;
+    expires_at: number | null;
+    is_active: boolean;
+    form_schema: string | null;
+    shipping_options: string | null;
+    collect_shipping_address: boolean;
+    return_url: string | null;
+    return_label: string | null;
+    branding: string | null;
+    fee_on_top: boolean;
+    items?: PaymentLinkItem[];
+    created_at: number;
+    updated_at: number;
+}
+export interface PaymentLinkItem {
+    object: "payment_link_item";
+    id: string;
+    payment_link_id: string;
+    product_id: string | null;
+    name: string;
+    description: string | null;
+    image_url: string | null;
+    amount: string;
+    quantity: number;
+    sort_order: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreatePaymentLinkParams {
+    name: string;
+    token_address: string;
+    chain_id: number;
+    recipient_address: string;
+    description?: string;
+    amount?: string;
+    min_amount?: string;
+    max_amount?: string;
+    suggested_amount?: string;
+    product_id?: string;
+    image_url?: string;
+    theme_color?: string;
+    button_text?: string;
+    max_uses?: number;
+    expires_at?: number;
+    form_schema?: Record<string, unknown>;
+    shipping_options?: Record<string, unknown>[];
+    collect_shipping_address?: boolean;
+    return_url?: string;
+    return_label?: string;
+    branding?: Record<string, unknown>;
+    fee_on_top?: boolean;
+    items?: CreatePaymentLinkItemParams[];
+}
+export interface CreatePaymentLinkItemParams {
+    name: string;
+    amount: string;
+    description?: string;
+    image_url?: string;
+    quantity?: number;
+    sort_order?: number;
+    product_id?: string;
+}
+export interface UpdatePaymentLinkParams extends Partial<Omit<CreatePaymentLinkParams, "items">> {
+    is_active?: boolean;
+    items?: CreatePaymentLinkItemParams[];
+}
+export interface ListPaymentLinksParams extends PaginationParams {
+    search?: string;
+    active?: "true" | "false";
+    sort?: "created_at" | "updated_at" | "name" | "current_uses";
+    order?: "asc" | "desc";
+}
+export interface PaymentLinkStats {
+    object: "payment_link_stats";
+    payment_link_id: string;
+    summary: {
+        total_views: number;
+        total_sessions: number;
+        total_completions: number;
+        lifetime_completions: number;
+        view_to_session_rate: string;
+        session_to_completion_rate: string;
+        overall_conversion_rate: string;
+    };
+    daily: {
+        views: {
+            date: string;
+            view_count: number;
+            unique_visitors: number;
+        }[];
+        sessions: {
+            date: string;
+            sessions: number;
+            completions: number;
+        }[];
+    };
+    utm_breakdown: Record<string, unknown>[];
+}
+export interface Product {
+    object: "product";
+    id: string;
+    name: string;
+    description: string | null;
+    image_url: string | null;
+    amount: string;
+    token_address: string;
+    chain_id: number;
+    recipient_address: string | null;
+    product_type: "one_time" | "subscription" | "variable";
+    is_active: boolean;
+    metadata: Record<string, unknown> | null;
+    form_schema: string | null;
+    shipping_options: string | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateProductParams {
+    name: string;
+    amount: string;
+    token_address: string;
+    chain_id: number;
+    description?: string;
+    image_url?: string;
+    recipient_address?: string;
+    product_type?: "one_time" | "subscription" | "variable";
+    metadata?: Record<string, unknown>;
+    form_schema?: Record<string, unknown>;
+    shipping_options?: Record<string, unknown>[];
+}
+export interface UpdateProductParams extends Partial<CreateProductParams> {
+    is_active?: boolean;
+}
+export interface Customer {
+    object: "customer";
+    id: string;
+    wallet_address: string;
+    name: string | null;
+    email: string | null;
+    metadata: Record<string, unknown> | null;
+    total_paid: string | null;
+    transaction_count: number;
+    first_payment_at: number | null;
+    last_payment_at: number | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateCustomerParams {
+    wallet_address: string;
+    name?: string;
+    email?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateCustomerParams {
+    name?: string;
+    email?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface Transaction {
+    object: "transaction";
+    id: string;
+    tx_hash: string;
+    chain_id: number;
+    from_address: string;
+    to_address: string;
+    token_address: string;
+    amount: string;
+    amount_usd: string | null;
+    status: "pending" | "confirming" | "completed" | "failed";
+    payment_link_id: string | null;
+    customer_id: string | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface TransactionStats {
+    object: "transaction_stats";
+    totalTransactions: number;
+    completedTransactions: number;
+    totalVolumeUsd: string;
+    last24h: {
+        transactions: number;
+        volumeUsd: string;
+    };
+    statusBreakdown: Record<string, number>;
+}
+export interface ListTransactionsParams extends PaginationParams {
+    status?: string;
+    customer_id?: string;
+    payment_link_id?: string;
+    from?: number;
+    to?: number;
+}
+export interface CheckoutSession {
+    object: "checkout_session";
+    id: string;
+    url: string | null;
+    status: "open" | "processing" | "completed" | "expired" | "failed";
+    payment_link_id: string | null;
+    product_id: string | null;
+    amount: string | null;
+    token_address: string;
+    chain_id: number;
+    recipient_address: string;
+    success_url: string | null;
+    cancel_url: string | null;
+    client_reference_id: string | null;
+    /** The API returns metadata as a serialized JSON string. Use JSON.parse() to recover the original object. */
+    metadata: string | null;
+    customer_email: string | null;
+    customer_name: string | null;
+    tx_hash: string | null;
+    completed_at: number | null;
+    expires_at: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateCheckoutSessionParams {
+    payment_link_id?: string;
+    token_address?: string;
+    chain_id?: number;
+    recipient_address?: string;
+    amount?: string;
+    product_id?: string;
+    success_url?: string;
+    cancel_url?: string;
+    client_reference_id?: string;
+    metadata?: Record<string, unknown>;
+    customer_email?: string;
+    customer_name?: string;
+    expires_in?: number;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+}
+export interface Webhook {
+    object: "webhook";
+    id: string;
+    url: string;
+    events: string[];
+    secret?: string;
+    is_active: boolean;
+    success_count: number;
+    failure_count: number;
+    last_triggered_at: number | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateWebhookParams {
+    url: string;
+    events: string[];
+    description?: string;
+}
+export interface UpdateWebhookParams {
+    url?: string;
+    events?: string[];
+    is_active?: boolean;
+}
+export interface DiscountCode {
+    object: "discount_code";
+    id: string;
+    code: string;
+    type: "percentage" | "fixed";
+    value: string;
+    payment_link_id: string | null;
+    max_uses: number | null;
+    current_uses: number;
+    min_order_amount: string | null;
+    expires_at: number | null;
+    is_active: boolean;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateDiscountCodeParams {
+    code: string;
+    type: "percentage" | "fixed";
+    value: string;
+    payment_link_id?: string;
+    max_uses?: number;
+    min_order_amount?: string;
+    expires_at?: number;
+}
+export interface BatchCreateDiscountCodesParams {
+    codes: string[];
+    type: "percentage" | "fixed";
+    value: string;
+    payment_link_id?: string;
+    max_uses?: number;
+    min_order_amount?: string;
+    expires_at?: number;
+}
+export interface NotificationSettings {
+    object: "notification_settings";
+    id: string;
+    email_enabled: boolean;
+    email_address: string | null;
+    telegram_enabled: boolean;
+    telegram_chat_id: string | null;
+    enabled_events: string[];
+}
+export interface UpdateNotificationSettingsParams {
+    email_enabled?: boolean;
+    email_address?: string;
+    telegram_enabled?: boolean;
+    enabled_events?: string[];
+}
+export interface WidgetConfig {
+    object: "widget_config";
+    id: string;
+    short_code: string;
+    name: string;
+    description: string | null;
+    widget_type: string;
+    config: string;
+    theme: string;
+    is_active: boolean;
+    current_views: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateWidgetParams {
+    name: string;
+    widget_type: "swap" | "checkout" | "nft" | "deposit";
+    config: Record<string, unknown>;
+    description?: string;
+    theme?: Record<string, unknown>;
+}
+export interface Organization {
+    object: "organization";
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    logo_url: string | null;
+    website_url: string | null;
+    default_recipient_address: string | null;
+    default_chain_id: number | null;
+    default_token_address: string | null;
+}
+export interface AnalyticsOverview {
+    object: "analytics_overview";
+    period: string;
+    revenue: {
+        period_usd: string;
+        period_transactions: number;
+        all_time_usd: string;
+        all_time_transactions: number;
+    };
+    customers: {
+        total: number;
+        new_in_period: number;
+    };
+    payment_links: {
+        total: number;
+        active: number;
+    };
+    conversion_rate: string;
+    daily: {
+        date: string;
+        transactions: number;
+        revenue_usd: number;
+    }[];
+    top_payment_links: Record<string, unknown>[];
+    top_tokens: Record<string, unknown>[];
+    top_chains: Record<string, unknown>[];
+}
+export interface ApiEvent {
+    object: "event";
+    id: string;
+    event_type: string;
+    resource_type: string;
+    resource_id: string | null;
+    ip_address: string | null;
+    request_method: string;
+    request_path: string;
+    status_code: number;
+    created_at: number;
+}
+export interface QuickPayParams {
+    recipient_address: string;
+    amount?: string;
+    token_address?: string;
+    chain_id?: number;
+    name?: string;
+    description?: string;
+    expires_in?: number;
+}
+export interface ApiKey {
+    object: "api_key";
+    id: string;
+    name: string;
+    prefix: string;
+    permissions: string[];
+    last_used_at: number | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface WebhookDelivery {
+    object: "webhook_delivery";
+    id: string;
+    webhook_id: string;
+    event_type: string;
+    url: string;
+    status: "pending" | "success" | "failed";
+    status_code: number | null;
+    response_body: string | null;
+    error_message: string | null;
+    attempted_at: number;
+    created_at: number;
+}
+export interface ValidateDiscountResult {
+    object: "discount_validation";
+    valid: boolean;
+    discount_code?: DiscountCode;
+    discount_amount?: string;
+    final_amount?: string;
+    reason?: string;
+}
+export interface BatchCreateResult {
+    object: "batch_result";
+    created: DiscountCode[];
+    errors: {
+        code: string;
+        error: string;
+    }[];
+}
+export interface ExportTransactionsParams {
+    format?: "csv" | "json";
+    status?: string;
+    from?: number;
+    to?: number;
+}
+export interface ExportCustomersParams {
+    format?: "csv" | "json";
+    from?: number;
+    to?: number;
+}

package/dist/cjs/anyspend/platform/types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * TypeScript types for the AnySpend Platform API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/anyspend/platform/utils/idempotency.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Idempotency key generation utility.
+ */
+export declare function generateIdempotencyKey(): string;

package/dist/cjs/anyspend/platform/utils/idempotency.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Idempotency key generation utility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateIdempotencyKey = generateIdempotencyKey;
+function generateIdempotencyKey() {
+    if (typeof crypto !== "undefined" && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback for environments without crypto.randomUUID
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, c => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}

package/dist/cjs/anyspend/platform/utils/pagination.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Auto-pagination async iterator for list endpoints.
+ */
+import type { ListResponse } from "../types";
+export interface AutoPaginateOptions {
+    startPage?: number;
+    limit?: number;
+}
+/**
+ * Creates an async iterator that automatically paginates through all results.
+ */
+export declare function autoPaginate<T>(fetchPage: (page: number, limit: number) => Promise<ListResponse<T>>, options?: AutoPaginateOptions): AsyncGenerator<T, void, undefined>;

package/dist/cjs/anyspend/platform/utils/pagination.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Auto-pagination async iterator for list endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.autoPaginate = autoPaginate;
+/**
+ * Creates an async iterator that automatically paginates through all results.
+ */
+async function* autoPaginate(fetchPage, options = {}) {
+    let page = options.startPage || 1;
+    const limit = options.limit || 100;
+    while (true) {
+        const result = await fetchPage(page, limit);
+        for (const item of result.data) {
+            yield item;
+        }
+        if (!result.has_more)
+            break;
+        page++;
+    }
+}

package/dist/esm/anyspend/platform/client.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Core HTTP client for the AnySpend Platform API.
+ * Handles authentication, retries, error parsing, and idempotency.
+ */
+export interface ClientConfig {
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+    idempotencyKeyGenerator?: () => string;
+}
+export declare const DEFAULT_BASE_URL = "https://platform-api.anyspend.com/api/v1";
+export declare class HttpClient {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    private maxRetries;
+    private generateIdempotencyKey;
+    constructor(apiKey: string, config?: ClientConfig);
+    get<T>(path: string, params?: object): Promise<T>;
+    post<T>(path: string, body?: object): Promise<T>;
+    patch<T>(path: string, body: object): Promise<T>;
+    delete<T>(path: string, body?: object): Promise<T>;
+    postFormData<T>(path: string, formData: FormData): Promise<T>;
+    private buildUrl;
+    private request;
+    private requestRaw;
+    private executeWithRetry;
+    private sleep;
+}
+/**
+ * Static HTTP client for unauthenticated requests (quick-pay).
+ */
+export declare class StaticHttpClient {
+    static post<T>(baseUrl: string, path: string, body: Record<string, unknown>): Promise<T>;
+}