@b3dotfun/sdk 0.1.68 → 0.1.69-alpha.0

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

@@ -0,0 +1,87 @@
+/**
+ * AnySpend Platform API Client
+ *
+ * A headless TypeScript client for the AnySpend Platform REST API.
+ * Works in any runtime with `fetch` (Node.js, browsers, Cloudflare Workers, Deno, Bun).
+ *
+ * @example
+ * ```typescript
+ * import { AnySpendPlatformClient } from '@b3dotfun/sdk/anyspend/platform';
+ *
+ * const platform = new AnySpendPlatformClient('asp_your_api_key_here');
+ *
+ * // Create a payment link
+ * const link = await platform.paymentLinks.create({
+ *   name: 'Summer Sale',
+ *   amount: '10000000',
+ *   token_address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+ *   chain_id: 8453,
+ *   recipient_address: '0x...',
+ * });
+ *
+ * // Quick pay (no API key needed)
+ * const quickLink = await AnySpendPlatformClient.quickPay({
+ *   recipient_address: '0x...',
+ *   amount: '5000000',
+ * });
+ * ```
+ */
+import { type ClientConfig } from "./client";
+import { PaymentLinksResource } from "./resources/payment-links";
+import { ProductsResource } from "./resources/products";
+import { CustomersResource } from "./resources/customers";
+import { TransactionsResource } from "./resources/transactions";
+import { CheckoutSessionsResource } from "./resources/checkout-sessions";
+import { WebhooksResource } from "./resources/webhooks";
+import { DiscountCodesResource } from "./resources/discount-codes";
+import { NotificationsResource } from "./resources/notifications";
+import { WidgetsResource } from "./resources/widgets";
+import { OrganizationResource } from "./resources/organization";
+import { AnalyticsResource } from "./resources/analytics";
+import { EventsResource } from "./resources/events";
+import type { QuickPayParams, PaymentLink } from "./types";
+export declare class AnySpendPlatformClient {
+    private client;
+    /** Payment Links - Create, manage, and track payment links */
+    readonly paymentLinks: PaymentLinksResource;
+    /** Products - Manage your product catalog */
+    readonly products: ProductsResource;
+    /** Customers - Manage customer records */
+    readonly customers: CustomersResource;
+    /** Transactions - View transaction history and stats */
+    readonly transactions: TransactionsResource;
+    /** Checkout Sessions - Server-side checkout management */
+    readonly checkoutSessions: CheckoutSessionsResource;
+    /** Webhooks - Configure webhook endpoints */
+    readonly webhooks: WebhooksResource;
+    /** Discount Codes - Create and validate discounts */
+    readonly discountCodes: DiscountCodesResource;
+    /** Notifications - Email and Telegram settings */
+    readonly notifications: NotificationsResource;
+    /** Widgets - Embeddable widget configurations */
+    readonly widgets: WidgetsResource;
+    /** Organization - Org settings and defaults */
+    readonly organization: OrganizationResource;
+    /** Analytics - Revenue and conversion analytics */
+    readonly analytics: AnalyticsResource;
+    /** Events - API audit trail */
+    readonly events: EventsResource;
+    /**
+     * Create a new AnySpend Platform API client.
+     *
+     * @param apiKey - Your API key (starts with `asp_`)
+     * @param config - Optional configuration
+     */
+    constructor(apiKey: string, config?: ClientConfig);
+    /**
+     * Create a quick payment link without authentication.
+     * Rate limited to 5 requests per minute per IP.
+     *
+     * @param params - Quick pay parameters
+     * @param baseUrl - Optional API base URL (defaults to production)
+     */
+    static quickPay(params: QuickPayParams, baseUrl?: string): Promise<PaymentLink>;
+}
+export type { ClientConfig } from "./client";
+export { ApiError, AuthenticationError, PermissionError, RateLimitError, NotFoundError, IdempotencyError, } from "./errors";
+export type * from "./types";

package/dist/types/anyspend/platform/resources/analytics.d.ts

@@ -0,0 +1,7 @@
+import type { HttpClient } from "../client";
+import type { AnalyticsOverview } from "../types";
+export declare class AnalyticsResource {
+    private client;
+    constructor(client: HttpClient);
+    overview(period?: "7d" | "30d" | "90d" | "all"): Promise<AnalyticsOverview>;
+}

package/dist/types/anyspend/platform/resources/checkout-sessions.d.ts

@@ -0,0 +1,17 @@
+import type { HttpClient } from "../client";
+import type { CheckoutSession, ListResponse, CreateCheckoutSessionParams, PaginationParams } from "../types";
+export interface ListCheckoutSessionsParams extends PaginationParams {
+    status?: "open" | "processing" | "completed" | "expired" | "failed";
+    payment_link_id?: string;
+    from?: number;
+    to?: number;
+}
+export declare class CheckoutSessionsResource {
+    private client;
+    constructor(client: HttpClient);
+    list(params?: ListCheckoutSessionsParams): Promise<ListResponse<CheckoutSession>>;
+    listAutoPaginate(params?: Omit<ListCheckoutSessionsParams, "page">): AsyncGenerator<CheckoutSession>;
+    create(params: CreateCheckoutSessionParams): Promise<CheckoutSession>;
+    get(id: string): Promise<CheckoutSession>;
+    expire(id: string): Promise<CheckoutSession>;
+}

package/dist/types/anyspend/platform/resources/customers.d.ts

@@ -0,0 +1,19 @@
+import type { HttpClient } from "../client";
+import type { Customer, Transaction, ListResponse, DeletedResponse, CreateCustomerParams, UpdateCustomerParams, ExportCustomersParams, PaginationParams } from "../types";
+export interface ListCustomersParams extends PaginationParams {
+    search?: string;
+    sort?: "created_at" | "updated_at" | "total_paid" | "transaction_count";
+    order?: "asc" | "desc";
+}
+export declare class CustomersResource {
+    private client;
+    constructor(client: HttpClient);
+    list(params?: ListCustomersParams): Promise<ListResponse<Customer>>;
+    listAutoPaginate(params?: Omit<ListCustomersParams, "page">): AsyncGenerator<Customer>;
+    create(params: CreateCustomerParams): Promise<Customer>;
+    get(id: string): Promise<Customer>;
+    update(id: string, params: UpdateCustomerParams): Promise<Customer>;
+    delete(id: string): Promise<DeletedResponse>;
+    transactions(id: string, params?: PaginationParams): Promise<ListResponse<Transaction>>;
+    export(params?: ExportCustomersParams): Promise<string>;
+}

package/dist/types/anyspend/platform/resources/discount-codes.d.ts

@@ -0,0 +1,29 @@
+import type { HttpClient } from "../client";
+import type { DiscountCode, ListResponse, DeletedResponse, CreateDiscountCodeParams, BatchCreateDiscountCodesParams, ValidateDiscountResult, BatchCreateResult, PaginationParams } from "../types";
+export interface ListDiscountCodesParams extends PaginationParams {
+    payment_link_id?: string;
+    active?: "true" | "false";
+    search?: string;
+}
+export interface UpdateDiscountCodeParams {
+    is_active?: boolean;
+    max_uses?: number;
+    min_order_amount?: string;
+    expires_at?: number;
+}
+export interface ValidateDiscountParams {
+    code: string;
+    payment_link_id?: string;
+    amount?: string;
+}
+export declare class DiscountCodesResource {
+    private client;
+    constructor(client: HttpClient);
+    list(params?: ListDiscountCodesParams): Promise<ListResponse<DiscountCode>>;
+    listAutoPaginate(params?: Omit<ListDiscountCodesParams, "page">): AsyncGenerator<DiscountCode>;
+    create(params: CreateDiscountCodeParams): Promise<DiscountCode>;
+    update(id: string, params: UpdateDiscountCodeParams): Promise<DiscountCode>;
+    delete(id: string): Promise<DeletedResponse>;
+    validate(params: ValidateDiscountParams): Promise<ValidateDiscountResult>;
+    batchCreate(params: BatchCreateDiscountCodesParams): Promise<BatchCreateResult>;
+}

package/dist/types/anyspend/platform/resources/events.d.ts

@@ -0,0 +1,14 @@
+import type { HttpClient } from "../client";
+import type { ApiEvent, ListResponse, PaginationParams } from "../types";
+export interface ListEventsParams extends PaginationParams {
+    event_type?: string;
+    resource_type?: string;
+    from?: number;
+    to?: number;
+}
+export declare class EventsResource {
+    private client;
+    constructor(client: HttpClient);
+    list(params?: ListEventsParams): Promise<ListResponse<ApiEvent>>;
+    listAutoPaginate(params?: Omit<ListEventsParams, "page">): AsyncGenerator<ApiEvent>;
+}

package/dist/types/anyspend/platform/resources/notifications.d.ts

@@ -0,0 +1,18 @@
+import type { HttpClient } from "../client";
+import type { NotificationSettings, UpdateNotificationSettingsParams, ActionResponse } from "../types";
+export interface TelegramLinkResult {
+    object: "telegram_link";
+    link_url: string;
+    link_code: string;
+    expires_at: number;
+}
+export declare class NotificationsResource {
+    private client;
+    constructor(client: HttpClient);
+    get(): Promise<NotificationSettings>;
+    update(params: UpdateNotificationSettingsParams): Promise<NotificationSettings>;
+    linkTelegram(): Promise<TelegramLinkResult>;
+    unlinkTelegram(): Promise<ActionResponse>;
+    testEmail(): Promise<ActionResponse>;
+    testTelegram(): Promise<ActionResponse>;
+}

package/dist/types/anyspend/platform/resources/organization.d.ts

@@ -0,0 +1,17 @@
+import type { HttpClient } from "../client";
+import type { Organization } from "../types";
+export interface UpdateOrganizationParams {
+    name?: string;
+    description?: string;
+    logo_url?: string;
+    website_url?: string;
+    default_recipient_address?: string;
+    default_chain_id?: number;
+    default_token_address?: string;
+}
+export declare class OrganizationResource {
+    private client;
+    constructor(client: HttpClient);
+    get(): Promise<Organization>;
+    update(params: UpdateOrganizationParams): Promise<Organization>;
+}

package/dist/types/anyspend/platform/resources/payment-links.d.ts

@@ -0,0 +1,21 @@
+import type { HttpClient } from "../client";
+import type { PaymentLink, PaymentLinkItem, PaymentLinkStats, CheckoutSession, ListResponse, DeletedResponse, CreatePaymentLinkParams, CreatePaymentLinkItemParams, UpdatePaymentLinkParams, ListPaymentLinksParams, PaginationParams } from "../types";
+export declare class PaymentLinksResource {
+    private client;
+    constructor(client: HttpClient);
+    list(params?: ListPaymentLinksParams): Promise<ListResponse<PaymentLink>>;
+    listAutoPaginate(params?: Omit<ListPaymentLinksParams, "page">): AsyncGenerator<PaymentLink>;
+    create(params: CreatePaymentLinkParams): Promise<PaymentLink>;
+    get(id: string): Promise<PaymentLink>;
+    update(id: string, params: UpdatePaymentLinkParams): Promise<PaymentLink>;
+    delete(id: string): Promise<DeletedResponse>;
+    duplicate(id: string, overrides?: Partial<CreatePaymentLinkParams>): Promise<PaymentLink>;
+    stats(id: string, days?: number): Promise<PaymentLinkStats>;
+    sessions(id: string, params?: PaginationParams): Promise<ListResponse<CheckoutSession>>;
+    visitors(id: string, params?: PaginationParams & {
+        days?: number;
+    }): Promise<ListResponse<Record<string, unknown>>>;
+    items(id: string): Promise<PaymentLinkItem[]>;
+    addItem(id: string, item: CreatePaymentLinkItemParams): Promise<PaymentLinkItem>;
+    removeItem(id: string, itemId: string): Promise<DeletedResponse>;
+}

package/dist/types/anyspend/platform/resources/products.d.ts

@@ -0,0 +1,27 @@
+import type { HttpClient } from "../client";
+import type { Product, PaymentLink, ListResponse, DeletedResponse, CreateProductParams, UpdateProductParams, PaginationParams } from "../types";
+export interface ListProductsParams extends PaginationParams {
+    search?: string;
+    active?: "true" | "false";
+    product_type?: "one_time" | "subscription" | "variable";
+    sort?: "created_at" | "updated_at" | "name";
+    order?: "asc" | "desc";
+}
+export interface GenerateLinkParams {
+    recipient_address?: string;
+    name?: string;
+    description?: string;
+    theme_color?: string;
+    button_text?: string;
+}
+export declare class ProductsResource {
+    private client;
+    constructor(client: HttpClient);
+    list(params?: ListProductsParams): Promise<ListResponse<Product>>;
+    listAutoPaginate(params?: Omit<ListProductsParams, "page">): AsyncGenerator<Product>;
+    create(params: CreateProductParams): Promise<Product>;
+    get(id: string): Promise<Product>;
+    update(id: string, params: UpdateProductParams): Promise<Product>;
+    delete(id: string): Promise<DeletedResponse>;
+    generateLink(id: string, params?: GenerateLinkParams): Promise<PaymentLink>;
+}

package/dist/types/anyspend/platform/resources/transactions.d.ts

@@ -0,0 +1,11 @@
+import type { HttpClient } from "../client";
+import type { Transaction, TransactionStats, ListResponse, ListTransactionsParams, ExportTransactionsParams } from "../types";
+export declare class TransactionsResource {
+    private client;
+    constructor(client: HttpClient);
+    list(params?: ListTransactionsParams): Promise<ListResponse<Transaction>>;
+    listAutoPaginate(params?: Omit<ListTransactionsParams, "page">): AsyncGenerator<Transaction>;
+    get(id: string): Promise<Transaction>;
+    stats(): Promise<TransactionStats>;
+    export(params?: ExportTransactionsParams): Promise<string>;
+}

package/dist/types/anyspend/platform/resources/webhooks.d.ts

@@ -0,0 +1,14 @@
+import type { HttpClient } from "../client";
+import type { Webhook, WebhookDelivery, ListResponse, DeletedResponse, ActionResponse, CreateWebhookParams, UpdateWebhookParams, PaginationParams } from "../types";
+export declare class WebhooksResource {
+    private client;
+    constructor(client: HttpClient);
+    list(): Promise<ListResponse<Webhook>>;
+    create(params: CreateWebhookParams): Promise<Webhook>;
+    get(id: string): Promise<Webhook>;
+    update(id: string, params: UpdateWebhookParams): Promise<Webhook>;
+    delete(id: string): Promise<DeletedResponse>;
+    test(id: string): Promise<ActionResponse>;
+    deliveries(id: string, params?: PaginationParams): Promise<ListResponse<WebhookDelivery>>;
+    retry(id: string, deliveryId: string): Promise<ActionResponse>;
+}

package/dist/types/anyspend/platform/resources/widgets.d.ts

@@ -0,0 +1,38 @@
+import type { HttpClient } from "../client";
+import type { WidgetConfig, ListResponse, DeletedResponse, CreateWidgetParams, PaginationParams } from "../types";
+export interface ListWidgetsParams extends PaginationParams {
+    search?: string;
+    widget_type?: "swap" | "checkout" | "nft" | "deposit";
+    active?: "true" | "false";
+    sort?: "created_at" | "updated_at" | "name" | "current_views";
+    order?: "asc" | "desc";
+}
+export interface UpdateWidgetParams extends Partial<CreateWidgetParams> {
+    is_active?: boolean;
+}
+export interface WidgetStats {
+    object: "widget_stats";
+    widget_id: string;
+    summary: {
+        total_views: number;
+        total_interactions: number;
+        total_completions: number;
+    };
+    daily: {
+        date: string;
+        views: number;
+        interactions: number;
+        completions: number;
+    }[];
+}
+export declare class WidgetsResource {
+    private client;
+    constructor(client: HttpClient);
+    list(params?: ListWidgetsParams): Promise<ListResponse<WidgetConfig>>;
+    listAutoPaginate(params?: Omit<ListWidgetsParams, "page">): AsyncGenerator<WidgetConfig>;
+    create(params: CreateWidgetParams): Promise<WidgetConfig>;
+    get(id: string): Promise<WidgetConfig>;
+    update(id: string, params: UpdateWidgetParams): Promise<WidgetConfig>;
+    delete(id: string): Promise<DeletedResponse>;
+    stats(id: string, days?: number): Promise<WidgetStats>;
+}