@sly_ai/sdk 0.1.0

package/dist/acp.d.ts

@@ -0,0 +1,201 @@
+import { S as SlyClient } from './client-CyJe3uWO.js';
+import './types-df1EICn_.js';
+
+/**
+ * Types for ACP (Agentic Commerce Protocol) - Stripe/OpenAI
+ */
+type CheckoutStatus = 'pending' | 'completed' | 'cancelled' | 'expired' | 'failed';
+interface CheckoutItem {
+    item_id?: string;
+    name: string;
+    description?: string;
+    image_url?: string;
+    quantity: number;
+    unit_price: number;
+    total_price: number;
+    currency?: string;
+    item_data?: Record<string, any>;
+}
+interface Checkout {
+    id: string;
+    checkout_id: string;
+    agent_id: string;
+    agent_name?: string;
+    merchant_id: string;
+    merchant_name?: string;
+    customer_id?: string;
+    customer_email?: string;
+    total_amount: number;
+    currency: string;
+    status: CheckoutStatus;
+    created_at: string;
+    completed_at?: string;
+}
+interface CheckoutWithItems extends Checkout {
+    session_id?: string;
+    account_id: string;
+    merchant_url?: string;
+    subtotal: number;
+    tax_amount: number;
+    shipping_amount: number;
+    discount_amount: number;
+    shared_payment_token?: string;
+    payment_method?: string;
+    transfer_id?: string;
+    checkout_data?: Record<string, any>;
+    shipping_address?: Record<string, any>;
+    metadata?: Record<string, any>;
+    updated_at?: string;
+    cancelled_at?: string;
+    expires_at?: string;
+    items: CheckoutItem[];
+}
+interface CreateCheckoutRequest {
+    checkout_id: string;
+    session_id?: string;
+    agent_id: string;
+    agent_name?: string;
+    customer_id?: string;
+    customer_email?: string;
+    account_id: string;
+    merchant_id: string;
+    merchant_name?: string;
+    merchant_url?: string;
+    items: CheckoutItem[];
+    tax_amount?: number;
+    shipping_amount?: number;
+    discount_amount?: number;
+    currency?: string;
+    shared_payment_token?: string;
+    payment_method?: string;
+    checkout_data?: Record<string, any>;
+    shipping_address?: Record<string, any>;
+    metadata?: Record<string, any>;
+    expires_at?: string;
+}
+interface CompleteCheckoutRequest {
+    shared_payment_token: string;
+    payment_method?: string;
+    idempotency_key?: string;
+}
+interface CompleteCheckoutResponse {
+    checkout_id: string;
+    transfer_id: string;
+    status: CheckoutStatus;
+    completed_at: string;
+    total_amount: number;
+    currency: string;
+}
+interface ListCheckoutsOptions {
+    status?: CheckoutStatus;
+    agent_id?: string;
+    merchant_id?: string;
+    customer_id?: string;
+    limit?: number;
+    offset?: number;
+}
+interface ListCheckoutsResponse {
+    data: Checkout[];
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+    };
+}
+
+/**
+ * ACP Client - Agentic Commerce Protocol (Stripe/OpenAI)
+ *
+ * Wraps PayOS ACP API endpoints for checkout-based payments.
+ */
+
+declare class ACPClient {
+    private client;
+    constructor(client: SlyClient);
+    /**
+     * Create a new ACP checkout session
+     *
+     * @example
+     * ```typescript
+     * const checkout = await payos.acp.createCheckout({
+     *   checkout_id: 'checkout_unique_123',
+     *   agent_id: 'agent_shopping_assistant',
+     *   account_id: 'acct_uuid',
+     *   merchant_id: 'merchant_store',
+     *   items: [
+     *     {
+     *       name: 'Product 1',
+     *       quantity: 2,
+     *       unit_price: 50.00,
+     *       total_price: 100.00,
+     *     },
+     *   ],
+     *   tax_amount: 10.00,
+     *   shipping_amount: 5.00,
+     * });
+     * ```
+     */
+    createCheckout(request: CreateCheckoutRequest): Promise<CheckoutWithItems>;
+    /**
+     * List checkouts with optional filtering
+     *
+     * @example
+     * ```typescript
+     * const { data, pagination } = await payos.acp.listCheckouts({
+     *   status: 'pending',
+     *   agent_id: 'agent_shopping_assistant',
+     *   limit: 20,
+     * });
+     * ```
+     */
+    listCheckouts(options?: ListCheckoutsOptions): Promise<ListCheckoutsResponse>;
+    /**
+     * Get checkout details with items
+     *
+     * @example
+     * ```typescript
+     * const checkout = await payos.acp.getCheckout('checkout_id');
+     * console.log(checkout.items);
+     * console.log(checkout.total_amount);
+     * ```
+     */
+    getCheckout(checkoutId: string): Promise<CheckoutWithItems>;
+    /**
+     * Complete a checkout with SharedPaymentToken
+     *
+     * @example
+     * ```typescript
+     * const result = await payos.acp.completeCheckout('checkout_id', {
+     *   shared_payment_token: 'spt_...',
+     *   payment_method: 'card',
+     * });
+     *
+     * console.log(result.transfer_id);
+     * console.log(result.status); // 'completed'
+     * ```
+     */
+    completeCheckout(checkoutId: string, request: CompleteCheckoutRequest): Promise<CompleteCheckoutResponse>;
+    /**
+     * Cancel a checkout
+     *
+     * @example
+     * ```typescript
+     * const result = await payos.acp.cancelCheckout('checkout_id');
+     * console.log(result.status); // 'cancelled'
+     * ```
+     */
+    cancelCheckout(checkoutId: string): Promise<Checkout>;
+    /**
+     * Get ACP analytics
+     *
+     * @example
+     * ```typescript
+     * const analytics = await payos.acp.getAnalytics('30d');
+     * console.log(analytics.summary.totalRevenue);
+     * console.log(analytics.summary.averageOrderValue);
+     * ```
+     */
+    getAnalytics(period?: '24h' | '7d' | '30d' | '90d' | '1y'): Promise<any>;
+}
+
+export { ACPClient, type Checkout, type CheckoutItem, type CheckoutStatus, type CheckoutWithItems, type CompleteCheckoutRequest, type CompleteCheckoutResponse, type CreateCheckoutRequest, type ListCheckoutsOptions, type ListCheckoutsResponse };

package/dist/acp.js

@@ -0,0 +1,143 @@
+'use strict';
+
+// src/protocols/acp/client.ts
+var ACPClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new ACP checkout session
+   * 
+   * @example
+   * ```typescript
+   * const checkout = await payos.acp.createCheckout({
+   *   checkout_id: 'checkout_unique_123',
+   *   agent_id: 'agent_shopping_assistant',
+   *   account_id: 'acct_uuid',
+   *   merchant_id: 'merchant_store',
+   *   items: [
+   *     {
+   *       name: 'Product 1',
+   *       quantity: 2,
+   *       unit_price: 50.00,
+   *       total_price: 100.00,
+   *     },
+   *   ],
+   *   tax_amount: 10.00,
+   *   shipping_amount: 5.00,
+   * });
+   * ```
+   */
+  async createCheckout(request) {
+    const response = await this.client.request(
+      "/v1/acp/checkouts",
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * List checkouts with optional filtering
+   * 
+   * @example
+   * ```typescript
+   * const { data, pagination } = await payos.acp.listCheckouts({
+   *   status: 'pending',
+   *   agent_id: 'agent_shopping_assistant',
+   *   limit: 20,
+   * });
+   * ```
+   */
+  async listCheckouts(options = {}) {
+    const params = new URLSearchParams();
+    if (options.status) params.append("status", options.status);
+    if (options.agent_id) params.append("agent_id", options.agent_id);
+    if (options.merchant_id) params.append("merchant_id", options.merchant_id);
+    if (options.customer_id) params.append("customer_id", options.customer_id);
+    if (options.limit) params.append("limit", options.limit.toString());
+    if (options.offset) params.append("offset", options.offset.toString());
+    const queryString = params.toString();
+    const path = queryString ? `/v1/acp/checkouts?${queryString}` : "/v1/acp/checkouts";
+    return this.client.request(path);
+  }
+  /**
+   * Get checkout details with items
+   * 
+   * @example
+   * ```typescript
+   * const checkout = await payos.acp.getCheckout('checkout_id');
+   * console.log(checkout.items);
+   * console.log(checkout.total_amount);
+   * ```
+   */
+  async getCheckout(checkoutId) {
+    const response = await this.client.request(
+      `/v1/acp/checkouts/${checkoutId}`
+    );
+    return response.data;
+  }
+  /**
+   * Complete a checkout with SharedPaymentToken
+   * 
+   * @example
+   * ```typescript
+   * const result = await payos.acp.completeCheckout('checkout_id', {
+   *   shared_payment_token: 'spt_...',
+   *   payment_method: 'card',
+   * });
+   * 
+   * console.log(result.transfer_id);
+   * console.log(result.status); // 'completed'
+   * ```
+   */
+  async completeCheckout(checkoutId, request) {
+    const response = await this.client.request(
+      `/v1/acp/checkouts/${checkoutId}/complete`,
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Cancel a checkout
+   * 
+   * @example
+   * ```typescript
+   * const result = await payos.acp.cancelCheckout('checkout_id');
+   * console.log(result.status); // 'cancelled'
+   * ```
+   */
+  async cancelCheckout(checkoutId) {
+    const response = await this.client.request(
+      `/v1/acp/checkouts/${checkoutId}/cancel`,
+      {
+        method: "PATCH"
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Get ACP analytics
+   * 
+   * @example
+   * ```typescript
+   * const analytics = await payos.acp.getAnalytics('30d');
+   * console.log(analytics.summary.totalRevenue);
+   * console.log(analytics.summary.averageOrderValue);
+   * ```
+   */
+  async getAnalytics(period = "30d") {
+    const response = await this.client.request(
+      `/v1/acp/analytics?period=${period}`
+    );
+    return response.data;
+  }
+};
+
+exports.ACPClient = ACPClient;
+//# sourceMappingURL=acp.js.map
+//# sourceMappingURL=acp.js.map

package/dist/acp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocols/acp/client.ts"],"names":[],"mappings":"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","file":"acp.js","sourcesContent":["/**\n * ACP Client - Agentic Commerce Protocol (Stripe/OpenAI)\n * \n * Wraps PayOS ACP API endpoints for checkout-based payments.\n */\n\nimport type { PayOSClient } from '../../client';\nimport type {\n  Checkout,\n  CheckoutWithItems,\n  CreateCheckoutRequest,\n  CompleteCheckoutRequest,\n  CompleteCheckoutResponse,\n  ListCheckoutsOptions,\n  ListCheckoutsResponse,\n} from './types';\n\nexport class ACPClient {\n  private client: PayOSClient;\n\n  constructor(client: PayOSClient) {\n    this.client = client;\n  }\n\n  /**\n   * Create a new ACP checkout session\n   * \n   * @example\n   * ```typescript\n   * const checkout = await payos.acp.createCheckout({\n   *   checkout_id: 'checkout_unique_123',\n   *   agent_id: 'agent_shopping_assistant',\n   *   account_id: 'acct_uuid',\n   *   merchant_id: 'merchant_store',\n   *   items: [\n   *     {\n   *       name: 'Product 1',\n   *       quantity: 2,\n   *       unit_price: 50.00,\n   *       total_price: 100.00,\n   *     },\n   *   ],\n   *   tax_amount: 10.00,\n   *   shipping_amount: 5.00,\n   * });\n   * ```\n   */\n  public async createCheckout(request: CreateCheckoutRequest): Promise<CheckoutWithItems> {\n    const response = await this.client.request<{ data: CheckoutWithItems }>(\n      '/v1/acp/checkouts',\n      {\n        method: 'POST',\n        body: JSON.stringify(request),\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * List checkouts with optional filtering\n   * \n   * @example\n   * ```typescript\n   * const { data, pagination } = await payos.acp.listCheckouts({\n   *   status: 'pending',\n   *   agent_id: 'agent_shopping_assistant',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  public async listCheckouts(options: ListCheckoutsOptions = {}): Promise<ListCheckoutsResponse> {\n    const params = new URLSearchParams();\n    if (options.status) params.append('status', options.status);\n    if (options.agent_id) params.append('agent_id', options.agent_id);\n    if (options.merchant_id) params.append('merchant_id', options.merchant_id);\n    if (options.customer_id) params.append('customer_id', options.customer_id);\n    if (options.limit) params.append('limit', options.limit.toString());\n    if (options.offset) params.append('offset', options.offset.toString());\n\n    const queryString = params.toString();\n    const path = queryString ? `/v1/acp/checkouts?${queryString}` : '/v1/acp/checkouts';\n\n    return this.client.request<ListCheckoutsResponse>(path);\n  }\n\n  /**\n   * Get checkout details with items\n   * \n   * @example\n   * ```typescript\n   * const checkout = await payos.acp.getCheckout('checkout_id');\n   * console.log(checkout.items);\n   * console.log(checkout.total_amount);\n   * ```\n   */\n  public async getCheckout(checkoutId: string): Promise<CheckoutWithItems> {\n    const response = await this.client.request<{ data: CheckoutWithItems }>(\n      `/v1/acp/checkouts/${checkoutId}`\n    );\n    return response.data;\n  }\n\n  /**\n   * Complete a checkout with SharedPaymentToken\n   * \n   * @example\n   * ```typescript\n   * const result = await payos.acp.completeCheckout('checkout_id', {\n   *   shared_payment_token: 'spt_...',\n   *   payment_method: 'card',\n   * });\n   * \n   * console.log(result.transfer_id);\n   * console.log(result.status); // 'completed'\n   * ```\n   */\n  public async completeCheckout(\n    checkoutId: string,\n    request: CompleteCheckoutRequest\n  ): Promise<CompleteCheckoutResponse> {\n    const response = await this.client.request<{ data: CompleteCheckoutResponse }>(\n      `/v1/acp/checkouts/${checkoutId}/complete`,\n      {\n        method: 'POST',\n        body: JSON.stringify(request),\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * Cancel a checkout\n   * \n   * @example\n   * ```typescript\n   * const result = await payos.acp.cancelCheckout('checkout_id');\n   * console.log(result.status); // 'cancelled'\n   * ```\n   */\n  public async cancelCheckout(checkoutId: string): Promise<Checkout> {\n    const response = await this.client.request<{ data: Checkout }>(\n      `/v1/acp/checkouts/${checkoutId}/cancel`,\n      {\n        method: 'PATCH',\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * Get ACP analytics\n   * \n   * @example\n   * ```typescript\n   * const analytics = await payos.acp.getAnalytics('30d');\n   * console.log(analytics.summary.totalRevenue);\n   * console.log(analytics.summary.averageOrderValue);\n   * ```\n   */\n  public async getAnalytics(period: '24h' | '7d' | '30d' | '90d' | '1y' = '30d') {\n    const response = await this.client.request<{ data: any }>(\n      `/v1/acp/analytics?period=${period}`\n    );\n    return response.data;\n  }\n}\n\n"]}

package/dist/acp.mjs

@@ -0,0 +1,141 @@
+// src/protocols/acp/client.ts
+var ACPClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new ACP checkout session
+   * 
+   * @example
+   * ```typescript
+   * const checkout = await payos.acp.createCheckout({
+   *   checkout_id: 'checkout_unique_123',
+   *   agent_id: 'agent_shopping_assistant',
+   *   account_id: 'acct_uuid',
+   *   merchant_id: 'merchant_store',
+   *   items: [
+   *     {
+   *       name: 'Product 1',
+   *       quantity: 2,
+   *       unit_price: 50.00,
+   *       total_price: 100.00,
+   *     },
+   *   ],
+   *   tax_amount: 10.00,
+   *   shipping_amount: 5.00,
+   * });
+   * ```
+   */
+  async createCheckout(request) {
+    const response = await this.client.request(
+      "/v1/acp/checkouts",
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * List checkouts with optional filtering
+   * 
+   * @example
+   * ```typescript
+   * const { data, pagination } = await payos.acp.listCheckouts({
+   *   status: 'pending',
+   *   agent_id: 'agent_shopping_assistant',
+   *   limit: 20,
+   * });
+   * ```
+   */
+  async listCheckouts(options = {}) {
+    const params = new URLSearchParams();
+    if (options.status) params.append("status", options.status);
+    if (options.agent_id) params.append("agent_id", options.agent_id);
+    if (options.merchant_id) params.append("merchant_id", options.merchant_id);
+    if (options.customer_id) params.append("customer_id", options.customer_id);
+    if (options.limit) params.append("limit", options.limit.toString());
+    if (options.offset) params.append("offset", options.offset.toString());
+    const queryString = params.toString();
+    const path = queryString ? `/v1/acp/checkouts?${queryString}` : "/v1/acp/checkouts";
+    return this.client.request(path);
+  }
+  /**
+   * Get checkout details with items
+   * 
+   * @example
+   * ```typescript
+   * const checkout = await payos.acp.getCheckout('checkout_id');
+   * console.log(checkout.items);
+   * console.log(checkout.total_amount);
+   * ```
+   */
+  async getCheckout(checkoutId) {
+    const response = await this.client.request(
+      `/v1/acp/checkouts/${checkoutId}`
+    );
+    return response.data;
+  }
+  /**
+   * Complete a checkout with SharedPaymentToken
+   * 
+   * @example
+   * ```typescript
+   * const result = await payos.acp.completeCheckout('checkout_id', {
+   *   shared_payment_token: 'spt_...',
+   *   payment_method: 'card',
+   * });
+   * 
+   * console.log(result.transfer_id);
+   * console.log(result.status); // 'completed'
+   * ```
+   */
+  async completeCheckout(checkoutId, request) {
+    const response = await this.client.request(
+      `/v1/acp/checkouts/${checkoutId}/complete`,
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Cancel a checkout
+   * 
+   * @example
+   * ```typescript
+   * const result = await payos.acp.cancelCheckout('checkout_id');
+   * console.log(result.status); // 'cancelled'
+   * ```
+   */
+  async cancelCheckout(checkoutId) {
+    const response = await this.client.request(
+      `/v1/acp/checkouts/${checkoutId}/cancel`,
+      {
+        method: "PATCH"
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Get ACP analytics
+   * 
+   * @example
+   * ```typescript
+   * const analytics = await payos.acp.getAnalytics('30d');
+   * console.log(analytics.summary.totalRevenue);
+   * console.log(analytics.summary.averageOrderValue);
+   * ```
+   */
+  async getAnalytics(period = "30d") {
+    const response = await this.client.request(
+      `/v1/acp/analytics?period=${period}`
+    );
+    return response.data;
+  }
+};
+
+export { ACPClient };
+//# sourceMappingURL=acp.mjs.map
+//# sourceMappingURL=acp.mjs.map

package/dist/acp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocols/acp/client.ts"],"names":[],"mappings":"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","file":"acp.mjs","sourcesContent":["/**\n * ACP Client - Agentic Commerce Protocol (Stripe/OpenAI)\n * \n * Wraps PayOS ACP API endpoints for checkout-based payments.\n */\n\nimport type { PayOSClient } from '../../client';\nimport type {\n  Checkout,\n  CheckoutWithItems,\n  CreateCheckoutRequest,\n  CompleteCheckoutRequest,\n  CompleteCheckoutResponse,\n  ListCheckoutsOptions,\n  ListCheckoutsResponse,\n} from './types';\n\nexport class ACPClient {\n  private client: PayOSClient;\n\n  constructor(client: PayOSClient) {\n    this.client = client;\n  }\n\n  /**\n   * Create a new ACP checkout session\n   * \n   * @example\n   * ```typescript\n   * const checkout = await payos.acp.createCheckout({\n   *   checkout_id: 'checkout_unique_123',\n   *   agent_id: 'agent_shopping_assistant',\n   *   account_id: 'acct_uuid',\n   *   merchant_id: 'merchant_store',\n   *   items: [\n   *     {\n   *       name: 'Product 1',\n   *       quantity: 2,\n   *       unit_price: 50.00,\n   *       total_price: 100.00,\n   *     },\n   *   ],\n   *   tax_amount: 10.00,\n   *   shipping_amount: 5.00,\n   * });\n   * ```\n   */\n  public async createCheckout(request: CreateCheckoutRequest): Promise<CheckoutWithItems> {\n    const response = await this.client.request<{ data: CheckoutWithItems }>(\n      '/v1/acp/checkouts',\n      {\n        method: 'POST',\n        body: JSON.stringify(request),\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * List checkouts with optional filtering\n   * \n   * @example\n   * ```typescript\n   * const { data, pagination } = await payos.acp.listCheckouts({\n   *   status: 'pending',\n   *   agent_id: 'agent_shopping_assistant',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  public async listCheckouts(options: ListCheckoutsOptions = {}): Promise<ListCheckoutsResponse> {\n    const params = new URLSearchParams();\n    if (options.status) params.append('status', options.status);\n    if (options.agent_id) params.append('agent_id', options.agent_id);\n    if (options.merchant_id) params.append('merchant_id', options.merchant_id);\n    if (options.customer_id) params.append('customer_id', options.customer_id);\n    if (options.limit) params.append('limit', options.limit.toString());\n    if (options.offset) params.append('offset', options.offset.toString());\n\n    const queryString = params.toString();\n    const path = queryString ? `/v1/acp/checkouts?${queryString}` : '/v1/acp/checkouts';\n\n    return this.client.request<ListCheckoutsResponse>(path);\n  }\n\n  /**\n   * Get checkout details with items\n   * \n   * @example\n   * ```typescript\n   * const checkout = await payos.acp.getCheckout('checkout_id');\n   * console.log(checkout.items);\n   * console.log(checkout.total_amount);\n   * ```\n   */\n  public async getCheckout(checkoutId: string): Promise<CheckoutWithItems> {\n    const response = await this.client.request<{ data: CheckoutWithItems }>(\n      `/v1/acp/checkouts/${checkoutId}`\n    );\n    return response.data;\n  }\n\n  /**\n   * Complete a checkout with SharedPaymentToken\n   * \n   * @example\n   * ```typescript\n   * const result = await payos.acp.completeCheckout('checkout_id', {\n   *   shared_payment_token: 'spt_...',\n   *   payment_method: 'card',\n   * });\n   * \n   * console.log(result.transfer_id);\n   * console.log(result.status); // 'completed'\n   * ```\n   */\n  public async completeCheckout(\n    checkoutId: string,\n    request: CompleteCheckoutRequest\n  ): Promise<CompleteCheckoutResponse> {\n    const response = await this.client.request<{ data: CompleteCheckoutResponse }>(\n      `/v1/acp/checkouts/${checkoutId}/complete`,\n      {\n        method: 'POST',\n        body: JSON.stringify(request),\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * Cancel a checkout\n   * \n   * @example\n   * ```typescript\n   * const result = await payos.acp.cancelCheckout('checkout_id');\n   * console.log(result.status); // 'cancelled'\n   * ```\n   */\n  public async cancelCheckout(checkoutId: string): Promise<Checkout> {\n    const response = await this.client.request<{ data: Checkout }>(\n      `/v1/acp/checkouts/${checkoutId}/cancel`,\n      {\n        method: 'PATCH',\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * Get ACP analytics\n   * \n   * @example\n   * ```typescript\n   * const analytics = await payos.acp.getAnalytics('30d');\n   * console.log(analytics.summary.totalRevenue);\n   * console.log(analytics.summary.averageOrderValue);\n   * ```\n   */\n  public async getAnalytics(period: '24h' | '7d' | '30d' | '90d' | '1y' = '30d') {\n    const response = await this.client.request<{ data: any }>(\n      `/v1/acp/analytics?period=${period}`\n    );\n    return response.data;\n  }\n}\n\n"]}