@sly_ai/sdk 0.1.0

package/dist/ap2.d.mts

@@ -0,0 +1,188 @@
+import { S as SlyClient } from './client-Cwe2CLU7.mjs';
+import './types-df1EICn_.mjs';
+
+/**
+ * Types for AP2 (Agent-to-Agent Protocol) - Google
+ */
+type MandateType = 'intent' | 'cart' | 'payment';
+type MandateStatus = 'active' | 'completed' | 'cancelled' | 'expired';
+interface Mandate {
+    id: string;
+    mandate_id: string;
+    mandate_type: MandateType;
+    agent_id: string;
+    agent_name?: string;
+    account_id: string;
+    authorized_amount: number;
+    used_amount: number;
+    remaining_amount: number;
+    currency: string;
+    status: MandateStatus;
+    execution_count: number;
+    expires_at?: string;
+    created_at: string;
+    updated_at?: string;
+    completed_at?: string;
+    cancelled_at?: string;
+}
+interface MandateWithExecutions extends Mandate {
+    mandate_data?: Record<string, any>;
+    a2a_session_id?: string;
+    metadata?: Record<string, any>;
+    executions: MandateExecution[];
+}
+interface MandateExecution {
+    id: string;
+    execution_index: number;
+    amount: number;
+    currency: string;
+    status: string;
+    transfer_id?: string;
+    created_at: string;
+    completed_at?: string;
+}
+interface CreateMandateRequest {
+    mandate_id: string;
+    mandate_type: MandateType;
+    agent_id: string;
+    agent_name?: string;
+    account_id: string;
+    authorized_amount: number;
+    currency?: string;
+    mandate_data?: Record<string, any>;
+    a2a_session_id?: string;
+    expires_at?: string;
+    metadata?: Record<string, any>;
+}
+interface ExecuteMandateRequest {
+    amount: number;
+    currency?: string;
+    authorization_proof?: string;
+    description?: string;
+    idempotency_key?: string;
+    order_ids?: string[];
+}
+interface ExecuteMandateResponse {
+    execution_id: string;
+    transfer_id: string;
+    mandate: {
+        id: string;
+        remaining_amount: number;
+        used_amount: number;
+        execution_count: number;
+        status: MandateStatus;
+    };
+    transfer: {
+        id: string;
+        amount: number;
+        currency: string;
+        status: string;
+        created_at: string;
+    };
+}
+interface ListMandatesOptions {
+    status?: MandateStatus;
+    agent_id?: string;
+    account_id?: string;
+    page?: number;
+    limit?: number;
+}
+interface ListMandatesResponse {
+    data: Mandate[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+
+/**
+ * AP2 Client - Google Agent-to-Agent Protocol
+ *
+ * Wraps PayOS AP2 API endpoints for mandate-based payments.
+ */
+
+declare class AP2Client {
+    private client;
+    constructor(client: SlyClient);
+    /**
+     * Create a new AP2 mandate
+     *
+     * @example
+     * ```typescript
+     * const mandate = await payos.ap2.createMandate({
+     *   mandate_id: 'mdt_unique_123',
+     *   mandate_type: 'payment',
+     *   agent_id: 'agent_ai_assistant',
+     *   account_id: 'acct_uuid',
+     *   authorized_amount: 100.00,
+     *   currency: 'USD',
+     * });
+     * ```
+     */
+    createMandate(request: CreateMandateRequest): Promise<Mandate>;
+    /**
+     * List mandates with optional filtering
+     *
+     * @example
+     * ```typescript
+     * const { data, pagination } = await payos.ap2.listMandates({
+     *   status: 'active',
+     *   agent_id: 'agent_ai_assistant',
+     *   limit: 50,
+     * });
+     * ```
+     */
+    listMandates(options?: ListMandatesOptions): Promise<ListMandatesResponse>;
+    /**
+     * Get mandate details with execution history
+     *
+     * @example
+     * ```typescript
+     * const mandate = await payos.ap2.getMandate('mdt_id');
+     * console.log(mandate.remaining_amount);
+     * console.log(mandate.executions.length);
+     * ```
+     */
+    getMandate(mandateId: string): Promise<MandateWithExecutions>;
+    /**
+     * Execute a payment against a mandate
+     *
+     * @example
+     * ```typescript
+     * const result = await payos.ap2.executeMandate('mdt_id', {
+     *   amount: 25.00,
+     *   currency: 'USD',
+     *   description: 'Monthly subscription',
+     * });
+     *
+     * console.log(result.transfer_id);
+     * console.log(result.mandate.remaining_amount);
+     * ```
+     */
+    executeMandate(mandateId: string, request: ExecuteMandateRequest): Promise<ExecuteMandateResponse>;
+    /**
+     * Cancel an active mandate
+     *
+     * @example
+     * ```typescript
+     * const result = await payos.ap2.cancelMandate('mdt_id');
+     * console.log(result.status); // 'cancelled'
+     * ```
+     */
+    cancelMandate(mandateId: string): Promise<Mandate>;
+    /**
+     * Get AP2 analytics
+     *
+     * @example
+     * ```typescript
+     * const analytics = await payos.ap2.getAnalytics('30d');
+     * console.log(analytics.summary.totalRevenue);
+     * console.log(analytics.summary.activeMandates);
+     * ```
+     */
+    getAnalytics(period?: '24h' | '7d' | '30d' | '90d' | '1y'): Promise<any>;
+}
+
+export { AP2Client, type CreateMandateRequest, type ExecuteMandateRequest, type ExecuteMandateResponse, type ListMandatesOptions, type ListMandatesResponse, type Mandate, type MandateExecution, type MandateStatus, type MandateType, type MandateWithExecutions };

package/dist/ap2.d.ts

@@ -0,0 +1,188 @@
+import { S as SlyClient } from './client-CyJe3uWO.js';
+import './types-df1EICn_.js';
+
+/**
+ * Types for AP2 (Agent-to-Agent Protocol) - Google
+ */
+type MandateType = 'intent' | 'cart' | 'payment';
+type MandateStatus = 'active' | 'completed' | 'cancelled' | 'expired';
+interface Mandate {
+    id: string;
+    mandate_id: string;
+    mandate_type: MandateType;
+    agent_id: string;
+    agent_name?: string;
+    account_id: string;
+    authorized_amount: number;
+    used_amount: number;
+    remaining_amount: number;
+    currency: string;
+    status: MandateStatus;
+    execution_count: number;
+    expires_at?: string;
+    created_at: string;
+    updated_at?: string;
+    completed_at?: string;
+    cancelled_at?: string;
+}
+interface MandateWithExecutions extends Mandate {
+    mandate_data?: Record<string, any>;
+    a2a_session_id?: string;
+    metadata?: Record<string, any>;
+    executions: MandateExecution[];
+}
+interface MandateExecution {
+    id: string;
+    execution_index: number;
+    amount: number;
+    currency: string;
+    status: string;
+    transfer_id?: string;
+    created_at: string;
+    completed_at?: string;
+}
+interface CreateMandateRequest {
+    mandate_id: string;
+    mandate_type: MandateType;
+    agent_id: string;
+    agent_name?: string;
+    account_id: string;
+    authorized_amount: number;
+    currency?: string;
+    mandate_data?: Record<string, any>;
+    a2a_session_id?: string;
+    expires_at?: string;
+    metadata?: Record<string, any>;
+}
+interface ExecuteMandateRequest {
+    amount: number;
+    currency?: string;
+    authorization_proof?: string;
+    description?: string;
+    idempotency_key?: string;
+    order_ids?: string[];
+}
+interface ExecuteMandateResponse {
+    execution_id: string;
+    transfer_id: string;
+    mandate: {
+        id: string;
+        remaining_amount: number;
+        used_amount: number;
+        execution_count: number;
+        status: MandateStatus;
+    };
+    transfer: {
+        id: string;
+        amount: number;
+        currency: string;
+        status: string;
+        created_at: string;
+    };
+}
+interface ListMandatesOptions {
+    status?: MandateStatus;
+    agent_id?: string;
+    account_id?: string;
+    page?: number;
+    limit?: number;
+}
+interface ListMandatesResponse {
+    data: Mandate[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+    };
+}
+
+/**
+ * AP2 Client - Google Agent-to-Agent Protocol
+ *
+ * Wraps PayOS AP2 API endpoints for mandate-based payments.
+ */
+
+declare class AP2Client {
+    private client;
+    constructor(client: SlyClient);
+    /**
+     * Create a new AP2 mandate
+     *
+     * @example
+     * ```typescript
+     * const mandate = await payos.ap2.createMandate({
+     *   mandate_id: 'mdt_unique_123',
+     *   mandate_type: 'payment',
+     *   agent_id: 'agent_ai_assistant',
+     *   account_id: 'acct_uuid',
+     *   authorized_amount: 100.00,
+     *   currency: 'USD',
+     * });
+     * ```
+     */
+    createMandate(request: CreateMandateRequest): Promise<Mandate>;
+    /**
+     * List mandates with optional filtering
+     *
+     * @example
+     * ```typescript
+     * const { data, pagination } = await payos.ap2.listMandates({
+     *   status: 'active',
+     *   agent_id: 'agent_ai_assistant',
+     *   limit: 50,
+     * });
+     * ```
+     */
+    listMandates(options?: ListMandatesOptions): Promise<ListMandatesResponse>;
+    /**
+     * Get mandate details with execution history
+     *
+     * @example
+     * ```typescript
+     * const mandate = await payos.ap2.getMandate('mdt_id');
+     * console.log(mandate.remaining_amount);
+     * console.log(mandate.executions.length);
+     * ```
+     */
+    getMandate(mandateId: string): Promise<MandateWithExecutions>;
+    /**
+     * Execute a payment against a mandate
+     *
+     * @example
+     * ```typescript
+     * const result = await payos.ap2.executeMandate('mdt_id', {
+     *   amount: 25.00,
+     *   currency: 'USD',
+     *   description: 'Monthly subscription',
+     * });
+     *
+     * console.log(result.transfer_id);
+     * console.log(result.mandate.remaining_amount);
+     * ```
+     */
+    executeMandate(mandateId: string, request: ExecuteMandateRequest): Promise<ExecuteMandateResponse>;
+    /**
+     * Cancel an active mandate
+     *
+     * @example
+     * ```typescript
+     * const result = await payos.ap2.cancelMandate('mdt_id');
+     * console.log(result.status); // 'cancelled'
+     * ```
+     */
+    cancelMandate(mandateId: string): Promise<Mandate>;
+    /**
+     * Get AP2 analytics
+     *
+     * @example
+     * ```typescript
+     * const analytics = await payos.ap2.getAnalytics('30d');
+     * console.log(analytics.summary.totalRevenue);
+     * console.log(analytics.summary.activeMandates);
+     * ```
+     */
+    getAnalytics(period?: '24h' | '7d' | '30d' | '90d' | '1y'): Promise<any>;
+}
+
+export { AP2Client, type CreateMandateRequest, type ExecuteMandateRequest, type ExecuteMandateResponse, type ListMandatesOptions, type ListMandatesResponse, type Mandate, type MandateExecution, type MandateStatus, type MandateType, type MandateWithExecutions };

package/dist/ap2.js

@@ -0,0 +1,135 @@
+'use strict';
+
+// src/protocols/ap2/client.ts
+var AP2Client = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new AP2 mandate
+   * 
+   * @example
+   * ```typescript
+   * const mandate = await payos.ap2.createMandate({
+   *   mandate_id: 'mdt_unique_123',
+   *   mandate_type: 'payment',
+   *   agent_id: 'agent_ai_assistant',
+   *   account_id: 'acct_uuid',
+   *   authorized_amount: 100.00,
+   *   currency: 'USD',
+   * });
+   * ```
+   */
+  async createMandate(request) {
+    const response = await this.client.request(
+      "/v1/ap2/mandates",
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * List mandates with optional filtering
+   * 
+   * @example
+   * ```typescript
+   * const { data, pagination } = await payos.ap2.listMandates({
+   *   status: 'active',
+   *   agent_id: 'agent_ai_assistant',
+   *   limit: 50,
+   * });
+   * ```
+   */
+  async listMandates(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.account_id) params.append("account_id", options.account_id);
+    if (options.page) params.append("page", options.page.toString());
+    if (options.limit) params.append("limit", options.limit.toString());
+    const queryString = params.toString();
+    const path = queryString ? `/v1/ap2/mandates?${queryString}` : "/v1/ap2/mandates";
+    return this.client.request(path);
+  }
+  /**
+   * Get mandate details with execution history
+   * 
+   * @example
+   * ```typescript
+   * const mandate = await payos.ap2.getMandate('mdt_id');
+   * console.log(mandate.remaining_amount);
+   * console.log(mandate.executions.length);
+   * ```
+   */
+  async getMandate(mandateId) {
+    const response = await this.client.request(
+      `/v1/ap2/mandates/${mandateId}`
+    );
+    return response.data;
+  }
+  /**
+   * Execute a payment against a mandate
+   * 
+   * @example
+   * ```typescript
+   * const result = await payos.ap2.executeMandate('mdt_id', {
+   *   amount: 25.00,
+   *   currency: 'USD',
+   *   description: 'Monthly subscription',
+   * });
+   * 
+   * console.log(result.transfer_id);
+   * console.log(result.mandate.remaining_amount);
+   * ```
+   */
+  async executeMandate(mandateId, request) {
+    const response = await this.client.request(
+      `/v1/ap2/mandates/${mandateId}/execute`,
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Cancel an active mandate
+   * 
+   * @example
+   * ```typescript
+   * const result = await payos.ap2.cancelMandate('mdt_id');
+   * console.log(result.status); // 'cancelled'
+   * ```
+   */
+  async cancelMandate(mandateId) {
+    const response = await this.client.request(
+      `/v1/ap2/mandates/${mandateId}/cancel`,
+      {
+        method: "PATCH"
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Get AP2 analytics
+   * 
+   * @example
+   * ```typescript
+   * const analytics = await payos.ap2.getAnalytics('30d');
+   * console.log(analytics.summary.totalRevenue);
+   * console.log(analytics.summary.activeMandates);
+   * ```
+   */
+  async getAnalytics(period = "30d") {
+    const response = await this.client.request(
+      `/v1/ap2/analytics?period=${period}`
+    );
+    return response.data;
+  }
+};
+
+exports.AP2Client = AP2Client;
+//# sourceMappingURL=ap2.js.map
+//# sourceMappingURL=ap2.js.map

package/dist/ap2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocols/ap2/client.ts"],"names":[],"mappings":"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","file":"ap2.js","sourcesContent":["/**\n * AP2 Client - Google Agent-to-Agent Protocol\n * \n * Wraps PayOS AP2 API endpoints for mandate-based payments.\n */\n\nimport type { PayOSClient } from '../../client';\nimport type {\n  Mandate,\n  MandateWithExecutions,\n  CreateMandateRequest,\n  ExecuteMandateRequest,\n  ExecuteMandateResponse,\n  ListMandatesOptions,\n  ListMandatesResponse,\n} from './types';\n\nexport class AP2Client {\n  private client: PayOSClient;\n\n  constructor(client: PayOSClient) {\n    this.client = client;\n  }\n\n  /**\n   * Create a new AP2 mandate\n   * \n   * @example\n   * ```typescript\n   * const mandate = await payos.ap2.createMandate({\n   *   mandate_id: 'mdt_unique_123',\n   *   mandate_type: 'payment',\n   *   agent_id: 'agent_ai_assistant',\n   *   account_id: 'acct_uuid',\n   *   authorized_amount: 100.00,\n   *   currency: 'USD',\n   * });\n   * ```\n   */\n  public async createMandate(request: CreateMandateRequest): Promise<Mandate> {\n    const response = await this.client.request<{ data: Mandate }>(\n      '/v1/ap2/mandates',\n      {\n        method: 'POST',\n        body: JSON.stringify(request),\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * List mandates with optional filtering\n   * \n   * @example\n   * ```typescript\n   * const { data, pagination } = await payos.ap2.listMandates({\n   *   status: 'active',\n   *   agent_id: 'agent_ai_assistant',\n   *   limit: 50,\n   * });\n   * ```\n   */\n  public async listMandates(options: ListMandatesOptions = {}): Promise<ListMandatesResponse> {\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.account_id) params.append('account_id', options.account_id);\n    if (options.page) params.append('page', options.page.toString());\n    if (options.limit) params.append('limit', options.limit.toString());\n\n    const queryString = params.toString();\n    const path = queryString ? `/v1/ap2/mandates?${queryString}` : '/v1/ap2/mandates';\n\n    return this.client.request<ListMandatesResponse>(path);\n  }\n\n  /**\n   * Get mandate details with execution history\n   * \n   * @example\n   * ```typescript\n   * const mandate = await payos.ap2.getMandate('mdt_id');\n   * console.log(mandate.remaining_amount);\n   * console.log(mandate.executions.length);\n   * ```\n   */\n  public async getMandate(mandateId: string): Promise<MandateWithExecutions> {\n    const response = await this.client.request<{ data: MandateWithExecutions }>(\n      `/v1/ap2/mandates/${mandateId}`\n    );\n    return response.data;\n  }\n\n  /**\n   * Execute a payment against a mandate\n   * \n   * @example\n   * ```typescript\n   * const result = await payos.ap2.executeMandate('mdt_id', {\n   *   amount: 25.00,\n   *   currency: 'USD',\n   *   description: 'Monthly subscription',\n   * });\n   * \n   * console.log(result.transfer_id);\n   * console.log(result.mandate.remaining_amount);\n   * ```\n   */\n  public async executeMandate(\n    mandateId: string,\n    request: ExecuteMandateRequest\n  ): Promise<ExecuteMandateResponse> {\n    const response = await this.client.request<{ data: ExecuteMandateResponse }>(\n      `/v1/ap2/mandates/${mandateId}/execute`,\n      {\n        method: 'POST',\n        body: JSON.stringify(request),\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * Cancel an active mandate\n   * \n   * @example\n   * ```typescript\n   * const result = await payos.ap2.cancelMandate('mdt_id');\n   * console.log(result.status); // 'cancelled'\n   * ```\n   */\n  public async cancelMandate(mandateId: string): Promise<Mandate> {\n    const response = await this.client.request<{ data: Mandate }>(\n      `/v1/ap2/mandates/${mandateId}/cancel`,\n      {\n        method: 'PATCH',\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * Get AP2 analytics\n   * \n   * @example\n   * ```typescript\n   * const analytics = await payos.ap2.getAnalytics('30d');\n   * console.log(analytics.summary.totalRevenue);\n   * console.log(analytics.summary.activeMandates);\n   * ```\n   */\n  public async getAnalytics(period: '24h' | '7d' | '30d' | '90d' | '1y' = '30d') {\n    const response = await this.client.request<{ data: any }>(\n      `/v1/ap2/analytics?period=${period}`\n    );\n    return response.data;\n  }\n}\n\n"]}

package/dist/ap2.mjs

@@ -0,0 +1,133 @@
+// src/protocols/ap2/client.ts
+var AP2Client = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new AP2 mandate
+   * 
+   * @example
+   * ```typescript
+   * const mandate = await payos.ap2.createMandate({
+   *   mandate_id: 'mdt_unique_123',
+   *   mandate_type: 'payment',
+   *   agent_id: 'agent_ai_assistant',
+   *   account_id: 'acct_uuid',
+   *   authorized_amount: 100.00,
+   *   currency: 'USD',
+   * });
+   * ```
+   */
+  async createMandate(request) {
+    const response = await this.client.request(
+      "/v1/ap2/mandates",
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * List mandates with optional filtering
+   * 
+   * @example
+   * ```typescript
+   * const { data, pagination } = await payos.ap2.listMandates({
+   *   status: 'active',
+   *   agent_id: 'agent_ai_assistant',
+   *   limit: 50,
+   * });
+   * ```
+   */
+  async listMandates(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.account_id) params.append("account_id", options.account_id);
+    if (options.page) params.append("page", options.page.toString());
+    if (options.limit) params.append("limit", options.limit.toString());
+    const queryString = params.toString();
+    const path = queryString ? `/v1/ap2/mandates?${queryString}` : "/v1/ap2/mandates";
+    return this.client.request(path);
+  }
+  /**
+   * Get mandate details with execution history
+   * 
+   * @example
+   * ```typescript
+   * const mandate = await payos.ap2.getMandate('mdt_id');
+   * console.log(mandate.remaining_amount);
+   * console.log(mandate.executions.length);
+   * ```
+   */
+  async getMandate(mandateId) {
+    const response = await this.client.request(
+      `/v1/ap2/mandates/${mandateId}`
+    );
+    return response.data;
+  }
+  /**
+   * Execute a payment against a mandate
+   * 
+   * @example
+   * ```typescript
+   * const result = await payos.ap2.executeMandate('mdt_id', {
+   *   amount: 25.00,
+   *   currency: 'USD',
+   *   description: 'Monthly subscription',
+   * });
+   * 
+   * console.log(result.transfer_id);
+   * console.log(result.mandate.remaining_amount);
+   * ```
+   */
+  async executeMandate(mandateId, request) {
+    const response = await this.client.request(
+      `/v1/ap2/mandates/${mandateId}/execute`,
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Cancel an active mandate
+   * 
+   * @example
+   * ```typescript
+   * const result = await payos.ap2.cancelMandate('mdt_id');
+   * console.log(result.status); // 'cancelled'
+   * ```
+   */
+  async cancelMandate(mandateId) {
+    const response = await this.client.request(
+      `/v1/ap2/mandates/${mandateId}/cancel`,
+      {
+        method: "PATCH"
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Get AP2 analytics
+   * 
+   * @example
+   * ```typescript
+   * const analytics = await payos.ap2.getAnalytics('30d');
+   * console.log(analytics.summary.totalRevenue);
+   * console.log(analytics.summary.activeMandates);
+   * ```
+   */
+  async getAnalytics(period = "30d") {
+    const response = await this.client.request(
+      `/v1/ap2/analytics?period=${period}`
+    );
+    return response.data;
+  }
+};
+
+export { AP2Client };
+//# sourceMappingURL=ap2.mjs.map
+//# sourceMappingURL=ap2.mjs.map

package/dist/ap2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocols/ap2/client.ts"],"names":[],"mappings":"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","file":"ap2.mjs","sourcesContent":["/**\n * AP2 Client - Google Agent-to-Agent Protocol\n * \n * Wraps PayOS AP2 API endpoints for mandate-based payments.\n */\n\nimport type { PayOSClient } from '../../client';\nimport type {\n  Mandate,\n  MandateWithExecutions,\n  CreateMandateRequest,\n  ExecuteMandateRequest,\n  ExecuteMandateResponse,\n  ListMandatesOptions,\n  ListMandatesResponse,\n} from './types';\n\nexport class AP2Client {\n  private client: PayOSClient;\n\n  constructor(client: PayOSClient) {\n    this.client = client;\n  }\n\n  /**\n   * Create a new AP2 mandate\n   * \n   * @example\n   * ```typescript\n   * const mandate = await payos.ap2.createMandate({\n   *   mandate_id: 'mdt_unique_123',\n   *   mandate_type: 'payment',\n   *   agent_id: 'agent_ai_assistant',\n   *   account_id: 'acct_uuid',\n   *   authorized_amount: 100.00,\n   *   currency: 'USD',\n   * });\n   * ```\n   */\n  public async createMandate(request: CreateMandateRequest): Promise<Mandate> {\n    const response = await this.client.request<{ data: Mandate }>(\n      '/v1/ap2/mandates',\n      {\n        method: 'POST',\n        body: JSON.stringify(request),\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * List mandates with optional filtering\n   * \n   * @example\n   * ```typescript\n   * const { data, pagination } = await payos.ap2.listMandates({\n   *   status: 'active',\n   *   agent_id: 'agent_ai_assistant',\n   *   limit: 50,\n   * });\n   * ```\n   */\n  public async listMandates(options: ListMandatesOptions = {}): Promise<ListMandatesResponse> {\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.account_id) params.append('account_id', options.account_id);\n    if (options.page) params.append('page', options.page.toString());\n    if (options.limit) params.append('limit', options.limit.toString());\n\n    const queryString = params.toString();\n    const path = queryString ? `/v1/ap2/mandates?${queryString}` : '/v1/ap2/mandates';\n\n    return this.client.request<ListMandatesResponse>(path);\n  }\n\n  /**\n   * Get mandate details with execution history\n   * \n   * @example\n   * ```typescript\n   * const mandate = await payos.ap2.getMandate('mdt_id');\n   * console.log(mandate.remaining_amount);\n   * console.log(mandate.executions.length);\n   * ```\n   */\n  public async getMandate(mandateId: string): Promise<MandateWithExecutions> {\n    const response = await this.client.request<{ data: MandateWithExecutions }>(\n      `/v1/ap2/mandates/${mandateId}`\n    );\n    return response.data;\n  }\n\n  /**\n   * Execute a payment against a mandate\n   * \n   * @example\n   * ```typescript\n   * const result = await payos.ap2.executeMandate('mdt_id', {\n   *   amount: 25.00,\n   *   currency: 'USD',\n   *   description: 'Monthly subscription',\n   * });\n   * \n   * console.log(result.transfer_id);\n   * console.log(result.mandate.remaining_amount);\n   * ```\n   */\n  public async executeMandate(\n    mandateId: string,\n    request: ExecuteMandateRequest\n  ): Promise<ExecuteMandateResponse> {\n    const response = await this.client.request<{ data: ExecuteMandateResponse }>(\n      `/v1/ap2/mandates/${mandateId}/execute`,\n      {\n        method: 'POST',\n        body: JSON.stringify(request),\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * Cancel an active mandate\n   * \n   * @example\n   * ```typescript\n   * const result = await payos.ap2.cancelMandate('mdt_id');\n   * console.log(result.status); // 'cancelled'\n   * ```\n   */\n  public async cancelMandate(mandateId: string): Promise<Mandate> {\n    const response = await this.client.request<{ data: Mandate }>(\n      `/v1/ap2/mandates/${mandateId}/cancel`,\n      {\n        method: 'PATCH',\n      }\n    );\n    return response.data;\n  }\n\n  /**\n   * Get AP2 analytics\n   * \n   * @example\n   * ```typescript\n   * const analytics = await payos.ap2.getAnalytics('30d');\n   * console.log(analytics.summary.totalRevenue);\n   * console.log(analytics.summary.activeMandates);\n   * ```\n   */\n  public async getAnalytics(period: '24h' | '7d' | '30d' | '90d' | '1y' = '30d') {\n    const response = await this.client.request<{ data: any }>(\n      `/v1/ap2/analytics?period=${period}`\n    );\n    return response.data;\n  }\n}\n\n"]}