torque-actions 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Torque
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# torque-actions
+
+Parse Assistant **`functionResults`** and call Torque **`POST /api/v1/execute/**`** routes with a Connect delegated JWT or smart wallet JWT.
+
+## Install
+
+```bash
+yarn add torque-actions @torquefi/types
+```
+
+```ts
+import { createTorqueActions, parseFunctionResults } from 'torque-actions'
+
+const parsed = parseFunctionResults(chat.functionResults)
+const actions = createTorqueActions({
+  accessToken: delegatedJwt,
+  baseUrl: 'https://app.torque.fi',
+})
+
+for (const item of parsed) {
+  if (item.kind === 'swap') {
+    await actions.buildEvmSwap(item.payload, 'retry-key-1')
+  }
+}
+```
+
+Unsigned responses must be signed by your wallet client (same contract as in-app `AssistantTransactionHandler`).

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import type { AssistantChatFunctionResult } from '@torquefi/types/assistant';
+import type { TorquePlatformClientConfig } from '@torquefi/types/platform';
+export type TorqueActionsOptions = TorquePlatformClientConfig & {
+    /** Delegated Connect JWT or in-app smart wallet JWT. */
+    accessToken: string;
+    timeout?: number;
+};
+export type ParsedSignableAction = {
+    kind: 'swap';
+    payload: Record<string, unknown>;
+} | {
+    kind: 'transfer';
+    payload: Record<string, unknown>;
+} | {
+    kind: 'lend';
+    payload: Record<string, unknown>;
+} | {
+    kind: 'borrow';
+    payload: Record<string, unknown>;
+} | {
+    kind: 'bridge';
+    payload: Record<string, unknown>;
+} | {
+    kind: 'advisory';
+    toolName: string;
+    payload: Record<string, unknown>;
+};
+/** Parse Assistant functionResults into signable vs advisory payloads. */
+export declare function parseFunctionResults(results: AssistantChatFunctionResult[] | undefined): ParsedSignableAction[];
+export declare class TorqueActionsError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+export declare class TorqueActions {
+    private readonly config;
+    constructor(config: TorqueActionsOptions);
+    private post;
+    buildEvmSwap(body: Record<string, unknown>, idempotencyKey?: string): Promise<unknown>;
+    buildEvmTransfer(body: Record<string, unknown>, idempotencyKey?: string): Promise<unknown>;
+    buildEvmLend(body: Record<string, unknown>, idempotencyKey?: string): Promise<unknown>;
+    buildEvmBorrow(body: Record<string, unknown>, idempotencyKey?: string): Promise<unknown>;
+    /** Refresh delegated Connect JWT via partner BFF (requires business API key on server). */
+    refreshDelegatedToken(params: {
+        apiKey: string;
+        refreshToken: string;
+    }): Promise<{
+        accessToken: string;
+        expiresIn: number;
+        scopes: string[];
+    }>;
+}
+export declare function createTorqueActions(config: TorqueActionsOptions): TorqueActions;

package/dist/index.esm.js

@@ -0,0 +1,122 @@
+const SIGNABLE_TOOLS = new Set([
+    'swap_tokens',
+    'getEnsoRoute',
+    'executeEnsoRoute',
+    'transfer_tokens',
+    'pay_invoice',
+    'lend_tokens',
+    'borrow_tokens',
+    'redeem_tokens',
+    'repay_tokens',
+    'bridge_tokens',
+    'swap_tokens_solana',
+    'transfer_tokens_solana',
+]);
+function resolveKind(toolName, result) {
+    const action = typeof result.action === 'string' ? result.action : '';
+    if (action === 'swap' || toolName.includes('swap') || toolName.includes('enso'))
+        return 'swap';
+    if (action === 'transfer' || toolName.includes('transfer') || toolName === 'pay_invoice')
+        return 'transfer';
+    if (action === 'lend' || toolName.includes('lend') || toolName === 'redeem_tokens')
+        return 'lend';
+    if (action === 'borrow' || toolName.includes('borrow') || toolName === 'repay_tokens')
+        return 'borrow';
+    if (action === 'bridge' || toolName === 'bridge_tokens')
+        return 'bridge';
+    return 'advisory';
+}
+/** Parse Assistant functionResults into signable vs advisory payloads. */
+function parseFunctionResults(results) {
+    if (!results?.length)
+        return [];
+    return results.map((fr) => {
+        const toolName = fr.toolName ?? '';
+        const payload = (fr.result ?? fr);
+        const requiresConfirmation = payload.requiresConfirmation === true;
+        const signable = SIGNABLE_TOOLS.has(toolName) && payload.success === true && requiresConfirmation;
+        if (!signable) {
+            return { kind: 'advisory', toolName, payload };
+        }
+        return { kind: resolveKind(toolName, payload), payload };
+    });
+}
+class TorqueActionsError extends Error {
+    constructor(message, code, statusCode = 400) {
+        super(message);
+        this.name = 'TorqueActionsError';
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+}
+class TorqueActions {
+    constructor(config) {
+        this.config = config;
+        if (!config.accessToken?.trim()) {
+            throw new TorqueActionsError('accessToken is required', 'INVALID_CONFIG');
+        }
+    }
+    async post(path, body, idempotencyKey) {
+        const baseUrl = (this.config.baseUrl || 'https://app.torque.fi').replace(/\/$/, '');
+        const headers = {
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.config.accessToken}`,
+        };
+        if (idempotencyKey?.trim())
+            headers['Idempotency-Key'] = idempotencyKey.trim();
+        const res = await fetch(`${baseUrl}${path}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        });
+        const data = await res.json().catch(() => ({}));
+        if (!res.ok) {
+            throw new TorqueActionsError(data?.error?.message ?? `HTTP ${res.status}`, data?.error?.code ?? 'EXECUTE_ERROR', res.status);
+        }
+        return data;
+    }
+    buildEvmSwap(body, idempotencyKey) {
+        return this.post('/api/v1/execute/trades', body, idempotencyKey);
+    }
+    buildEvmTransfer(body, idempotencyKey) {
+        return this.post('/api/v1/execute/transfers/evm', body, idempotencyKey);
+    }
+    buildEvmLend(body, idempotencyKey) {
+        return this.post('/api/v1/execute/lends/evm', body, idempotencyKey);
+    }
+    buildEvmBorrow(body, idempotencyKey) {
+        return this.post('/api/v1/execute/borrows/evm', body, idempotencyKey);
+    }
+    /** Refresh delegated Connect JWT via partner BFF (requires business API key on server). */
+    async refreshDelegatedToken(params) {
+        const baseUrl = (this.config.baseUrl || 'https://app.torque.fi').replace(/\/$/, '');
+        const res = await fetch(`${baseUrl}/api/v1/connect/token`, {
+            method: 'POST',
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${params.apiKey}`,
+            },
+            body: JSON.stringify({
+                grant_type: 'refresh_token',
+                refresh_token: params.refreshToken,
+            }),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok || !data.accessToken) {
+            throw new TorqueActionsError(data.error?.message ?? `HTTP ${res.status}`, data.error?.code ?? 'REFRESH_ERROR', res.status);
+        }
+        return {
+            accessToken: data.accessToken,
+            expiresIn: data.expiresIn ?? 3600,
+            scopes: data.scopes ?? [],
+        };
+    }
+}
+function createTorqueActions(config) {
+    return new TorqueActions(config);
+}
+
+export { TorqueActions, TorqueActionsError, createTorqueActions, parseFunctionResults };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":["import type { AssistantChatFunctionResult } from '@torquefi/types/assistant'\nimport type { TorquePlatformClientConfig } from '@torquefi/types/platform'\n\nexport type TorqueActionsOptions = TorquePlatformClientConfig & {\n  /** Delegated Connect JWT or in-app smart wallet JWT. */\n  accessToken: string\n  timeout?: number\n}\n\nexport type ParsedSignableAction =\n  | { kind: 'swap'; payload: Record<string, unknown> }\n  | { kind: 'transfer'; payload: Record<string, unknown> }\n  | { kind: 'lend'; payload: Record<string, unknown> }\n  | { kind: 'borrow'; payload: Record<string, unknown> }\n  | { kind: 'bridge'; payload: Record<string, unknown> }\n  | { kind: 'advisory'; toolName: string; payload: Record<string, unknown> }\n\nconst SIGNABLE_TOOLS = new Set([\n  'swap_tokens',\n  'getEnsoRoute',\n  'executeEnsoRoute',\n  'transfer_tokens',\n  'pay_invoice',\n  'lend_tokens',\n  'borrow_tokens',\n  'redeem_tokens',\n  'repay_tokens',\n  'bridge_tokens',\n  'swap_tokens_solana',\n  'transfer_tokens_solana',\n])\n\nfunction resolveKind(toolName: string, result: Record<string, unknown>): ParsedSignableAction['kind'] {\n  const action = typeof result.action === 'string' ? result.action : ''\n  if (action === 'swap' || toolName.includes('swap') || toolName.includes('enso')) return 'swap'\n  if (action === 'transfer' || toolName.includes('transfer') || toolName === 'pay_invoice') return 'transfer'\n  if (action === 'lend' || toolName.includes('lend') || toolName === 'redeem_tokens') return 'lend'\n  if (action === 'borrow' || toolName.includes('borrow') || toolName === 'repay_tokens') return 'borrow'\n  if (action === 'bridge' || toolName === 'bridge_tokens') return 'bridge'\n  return 'advisory'\n}\n\n/** Parse Assistant functionResults into signable vs advisory payloads. */\nexport function parseFunctionResults(\n  results: AssistantChatFunctionResult[] | undefined,\n): ParsedSignableAction[] {\n  if (!results?.length) return []\n\n  return results.map((fr) => {\n    const toolName = fr.toolName ?? ''\n    const payload = (fr.result ?? fr) as Record<string, unknown>\n    const requiresConfirmation = payload.requiresConfirmation === true\n    const signable = SIGNABLE_TOOLS.has(toolName) && payload.success === true && requiresConfirmation\n\n    if (!signable) {\n      return { kind: 'advisory', toolName, payload }\n    }\n\n    return { kind: resolveKind(toolName, payload), payload }\n  })\n}\n\nexport class TorqueActionsError extends Error {\n  code: string\n  statusCode: number\n\n  constructor(message: string, code: string, statusCode = 400) {\n    super(message)\n    this.name = 'TorqueActionsError'\n    this.code = code\n    this.statusCode = statusCode\n  }\n}\n\nexport class TorqueActions {\n  constructor(private readonly config: TorqueActionsOptions) {\n    if (!config.accessToken?.trim()) {\n      throw new TorqueActionsError('accessToken is required', 'INVALID_CONFIG')\n    }\n  }\n\n  private async post(path: string, body: unknown, idempotencyKey?: string): Promise<unknown> {\n    const baseUrl = (this.config.baseUrl || 'https://app.torque.fi').replace(/\\/$/, '')\n    const headers: Record<string, string> = {\n      Accept: 'application/json',\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${this.config.accessToken}`,\n    }\n    if (idempotencyKey?.trim()) headers['Idempotency-Key'] = idempotencyKey.trim()\n\n    const res = await fetch(`${baseUrl}${path}`, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(body),\n    })\n    const data = await res.json().catch(() => ({}))\n    if (!res.ok) {\n      throw new TorqueActionsError(\n        (data as { error?: { message?: string } })?.error?.message ?? `HTTP ${res.status}`,\n        (data as { error?: { code?: string } })?.error?.code ?? 'EXECUTE_ERROR',\n        res.status,\n      )\n    }\n    return data\n  }\n\n  buildEvmSwap(body: Record<string, unknown>, idempotencyKey?: string) {\n    return this.post('/api/v1/execute/trades', body, idempotencyKey)\n  }\n\n  buildEvmTransfer(body: Record<string, unknown>, idempotencyKey?: string) {\n    return this.post('/api/v1/execute/transfers/evm', body, idempotencyKey)\n  }\n\n  buildEvmLend(body: Record<string, unknown>, idempotencyKey?: string) {\n    return this.post('/api/v1/execute/lends/evm', body, idempotencyKey)\n  }\n\n  buildEvmBorrow(body: Record<string, unknown>, idempotencyKey?: string) {\n    return this.post('/api/v1/execute/borrows/evm', body, idempotencyKey)\n  }\n\n  /** Refresh delegated Connect JWT via partner BFF (requires business API key on server). */\n  async refreshDelegatedToken(params: {\n    apiKey: string\n    refreshToken: string\n  }): Promise<{ accessToken: string; expiresIn: number; scopes: string[] }> {\n    const baseUrl = (this.config.baseUrl || 'https://app.torque.fi').replace(/\\/$/, '')\n    const res = await fetch(`${baseUrl}/api/v1/connect/token`, {\n      method: 'POST',\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${params.apiKey}`,\n      },\n      body: JSON.stringify({\n        grant_type: 'refresh_token',\n        refresh_token: params.refreshToken,\n      }),\n    })\n    const data = (await res.json().catch(() => ({}))) as {\n      accessToken?: string\n      expiresIn?: number\n      scopes?: string[]\n      error?: { message?: string; code?: string }\n    }\n    if (!res.ok || !data.accessToken) {\n      throw new TorqueActionsError(\n        data.error?.message ?? `HTTP ${res.status}`,\n        data.error?.code ?? 'REFRESH_ERROR',\n        res.status,\n      )\n    }\n    return {\n      accessToken: data.accessToken,\n      expiresIn: data.expiresIn ?? 3600,\n      scopes: data.scopes ?? [],\n    }\n  }\n}\n\nexport function createTorqueActions(config: TorqueActionsOptions): TorqueActions {\n  return new TorqueActions(config)\n}\n"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,127 @@
+'use strict';
+
+const SIGNABLE_TOOLS = new Set([
+    'swap_tokens',
+    'getEnsoRoute',
+    'executeEnsoRoute',
+    'transfer_tokens',
+    'pay_invoice',
+    'lend_tokens',
+    'borrow_tokens',
+    'redeem_tokens',
+    'repay_tokens',
+    'bridge_tokens',
+    'swap_tokens_solana',
+    'transfer_tokens_solana',
+]);
+function resolveKind(toolName, result) {
+    const action = typeof result.action === 'string' ? result.action : '';
+    if (action === 'swap' || toolName.includes('swap') || toolName.includes('enso'))
+        return 'swap';
+    if (action === 'transfer' || toolName.includes('transfer') || toolName === 'pay_invoice')
+        return 'transfer';
+    if (action === 'lend' || toolName.includes('lend') || toolName === 'redeem_tokens')
+        return 'lend';
+    if (action === 'borrow' || toolName.includes('borrow') || toolName === 'repay_tokens')
+        return 'borrow';
+    if (action === 'bridge' || toolName === 'bridge_tokens')
+        return 'bridge';
+    return 'advisory';
+}
+/** Parse Assistant functionResults into signable vs advisory payloads. */
+function parseFunctionResults(results) {
+    if (!results?.length)
+        return [];
+    return results.map((fr) => {
+        const toolName = fr.toolName ?? '';
+        const payload = (fr.result ?? fr);
+        const requiresConfirmation = payload.requiresConfirmation === true;
+        const signable = SIGNABLE_TOOLS.has(toolName) && payload.success === true && requiresConfirmation;
+        if (!signable) {
+            return { kind: 'advisory', toolName, payload };
+        }
+        return { kind: resolveKind(toolName, payload), payload };
+    });
+}
+class TorqueActionsError extends Error {
+    constructor(message, code, statusCode = 400) {
+        super(message);
+        this.name = 'TorqueActionsError';
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+}
+class TorqueActions {
+    constructor(config) {
+        this.config = config;
+        if (!config.accessToken?.trim()) {
+            throw new TorqueActionsError('accessToken is required', 'INVALID_CONFIG');
+        }
+    }
+    async post(path, body, idempotencyKey) {
+        const baseUrl = (this.config.baseUrl || 'https://app.torque.fi').replace(/\/$/, '');
+        const headers = {
+            Accept: 'application/json',
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.config.accessToken}`,
+        };
+        if (idempotencyKey?.trim())
+            headers['Idempotency-Key'] = idempotencyKey.trim();
+        const res = await fetch(`${baseUrl}${path}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        });
+        const data = await res.json().catch(() => ({}));
+        if (!res.ok) {
+            throw new TorqueActionsError(data?.error?.message ?? `HTTP ${res.status}`, data?.error?.code ?? 'EXECUTE_ERROR', res.status);
+        }
+        return data;
+    }
+    buildEvmSwap(body, idempotencyKey) {
+        return this.post('/api/v1/execute/trades', body, idempotencyKey);
+    }
+    buildEvmTransfer(body, idempotencyKey) {
+        return this.post('/api/v1/execute/transfers/evm', body, idempotencyKey);
+    }
+    buildEvmLend(body, idempotencyKey) {
+        return this.post('/api/v1/execute/lends/evm', body, idempotencyKey);
+    }
+    buildEvmBorrow(body, idempotencyKey) {
+        return this.post('/api/v1/execute/borrows/evm', body, idempotencyKey);
+    }
+    /** Refresh delegated Connect JWT via partner BFF (requires business API key on server). */
+    async refreshDelegatedToken(params) {
+        const baseUrl = (this.config.baseUrl || 'https://app.torque.fi').replace(/\/$/, '');
+        const res = await fetch(`${baseUrl}/api/v1/connect/token`, {
+            method: 'POST',
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${params.apiKey}`,
+            },
+            body: JSON.stringify({
+                grant_type: 'refresh_token',
+                refresh_token: params.refreshToken,
+            }),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok || !data.accessToken) {
+            throw new TorqueActionsError(data.error?.message ?? `HTTP ${res.status}`, data.error?.code ?? 'REFRESH_ERROR', res.status);
+        }
+        return {
+            accessToken: data.accessToken,
+            expiresIn: data.expiresIn ?? 3600,
+            scopes: data.scopes ?? [],
+        };
+    }
+}
+function createTorqueActions(config) {
+    return new TorqueActions(config);
+}
+
+exports.TorqueActions = TorqueActions;
+exports.TorqueActionsError = TorqueActionsError;
+exports.createTorqueActions = createTorqueActions;
+exports.parseFunctionResults = parseFunctionResults;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import type { AssistantChatFunctionResult } from '@torquefi/types/assistant'\nimport type { TorquePlatformClientConfig } from '@torquefi/types/platform'\n\nexport type TorqueActionsOptions = TorquePlatformClientConfig & {\n  /** Delegated Connect JWT or in-app smart wallet JWT. */\n  accessToken: string\n  timeout?: number\n}\n\nexport type ParsedSignableAction =\n  | { kind: 'swap'; payload: Record<string, unknown> }\n  | { kind: 'transfer'; payload: Record<string, unknown> }\n  | { kind: 'lend'; payload: Record<string, unknown> }\n  | { kind: 'borrow'; payload: Record<string, unknown> }\n  | { kind: 'bridge'; payload: Record<string, unknown> }\n  | { kind: 'advisory'; toolName: string; payload: Record<string, unknown> }\n\nconst SIGNABLE_TOOLS = new Set([\n  'swap_tokens',\n  'getEnsoRoute',\n  'executeEnsoRoute',\n  'transfer_tokens',\n  'pay_invoice',\n  'lend_tokens',\n  'borrow_tokens',\n  'redeem_tokens',\n  'repay_tokens',\n  'bridge_tokens',\n  'swap_tokens_solana',\n  'transfer_tokens_solana',\n])\n\nfunction resolveKind(toolName: string, result: Record<string, unknown>): ParsedSignableAction['kind'] {\n  const action = typeof result.action === 'string' ? result.action : ''\n  if (action === 'swap' || toolName.includes('swap') || toolName.includes('enso')) return 'swap'\n  if (action === 'transfer' || toolName.includes('transfer') || toolName === 'pay_invoice') return 'transfer'\n  if (action === 'lend' || toolName.includes('lend') || toolName === 'redeem_tokens') return 'lend'\n  if (action === 'borrow' || toolName.includes('borrow') || toolName === 'repay_tokens') return 'borrow'\n  if (action === 'bridge' || toolName === 'bridge_tokens') return 'bridge'\n  return 'advisory'\n}\n\n/** Parse Assistant functionResults into signable vs advisory payloads. */\nexport function parseFunctionResults(\n  results: AssistantChatFunctionResult[] | undefined,\n): ParsedSignableAction[] {\n  if (!results?.length) return []\n\n  return results.map((fr) => {\n    const toolName = fr.toolName ?? ''\n    const payload = (fr.result ?? fr) as Record<string, unknown>\n    const requiresConfirmation = payload.requiresConfirmation === true\n    const signable = SIGNABLE_TOOLS.has(toolName) && payload.success === true && requiresConfirmation\n\n    if (!signable) {\n      return { kind: 'advisory', toolName, payload }\n    }\n\n    return { kind: resolveKind(toolName, payload), payload }\n  })\n}\n\nexport class TorqueActionsError extends Error {\n  code: string\n  statusCode: number\n\n  constructor(message: string, code: string, statusCode = 400) {\n    super(message)\n    this.name = 'TorqueActionsError'\n    this.code = code\n    this.statusCode = statusCode\n  }\n}\n\nexport class TorqueActions {\n  constructor(private readonly config: TorqueActionsOptions) {\n    if (!config.accessToken?.trim()) {\n      throw new TorqueActionsError('accessToken is required', 'INVALID_CONFIG')\n    }\n  }\n\n  private async post(path: string, body: unknown, idempotencyKey?: string): Promise<unknown> {\n    const baseUrl = (this.config.baseUrl || 'https://app.torque.fi').replace(/\\/$/, '')\n    const headers: Record<string, string> = {\n      Accept: 'application/json',\n      'Content-Type': 'application/json',\n      Authorization: `Bearer ${this.config.accessToken}`,\n    }\n    if (idempotencyKey?.trim()) headers['Idempotency-Key'] = idempotencyKey.trim()\n\n    const res = await fetch(`${baseUrl}${path}`, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(body),\n    })\n    const data = await res.json().catch(() => ({}))\n    if (!res.ok) {\n      throw new TorqueActionsError(\n        (data as { error?: { message?: string } })?.error?.message ?? `HTTP ${res.status}`,\n        (data as { error?: { code?: string } })?.error?.code ?? 'EXECUTE_ERROR',\n        res.status,\n      )\n    }\n    return data\n  }\n\n  buildEvmSwap(body: Record<string, unknown>, idempotencyKey?: string) {\n    return this.post('/api/v1/execute/trades', body, idempotencyKey)\n  }\n\n  buildEvmTransfer(body: Record<string, unknown>, idempotencyKey?: string) {\n    return this.post('/api/v1/execute/transfers/evm', body, idempotencyKey)\n  }\n\n  buildEvmLend(body: Record<string, unknown>, idempotencyKey?: string) {\n    return this.post('/api/v1/execute/lends/evm', body, idempotencyKey)\n  }\n\n  buildEvmBorrow(body: Record<string, unknown>, idempotencyKey?: string) {\n    return this.post('/api/v1/execute/borrows/evm', body, idempotencyKey)\n  }\n\n  /** Refresh delegated Connect JWT via partner BFF (requires business API key on server). */\n  async refreshDelegatedToken(params: {\n    apiKey: string\n    refreshToken: string\n  }): Promise<{ accessToken: string; expiresIn: number; scopes: string[] }> {\n    const baseUrl = (this.config.baseUrl || 'https://app.torque.fi').replace(/\\/$/, '')\n    const res = await fetch(`${baseUrl}/api/v1/connect/token`, {\n      method: 'POST',\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${params.apiKey}`,\n      },\n      body: JSON.stringify({\n        grant_type: 'refresh_token',\n        refresh_token: params.refreshToken,\n      }),\n    })\n    const data = (await res.json().catch(() => ({}))) as {\n      accessToken?: string\n      expiresIn?: number\n      scopes?: string[]\n      error?: { message?: string; code?: string }\n    }\n    if (!res.ok || !data.accessToken) {\n      throw new TorqueActionsError(\n        data.error?.message ?? `HTTP ${res.status}`,\n        data.error?.code ?? 'REFRESH_ERROR',\n        res.status,\n      )\n    }\n    return {\n      accessToken: data.accessToken,\n      expiresIn: data.expiresIn ?? 3600,\n      scopes: data.scopes ?? [],\n    }\n  }\n}\n\nexport function createTorqueActions(config: TorqueActionsOptions): TorqueActions {\n  return new TorqueActions(config)\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "torque-actions",
+  "version": "0.1.0",
+  "description": "Torque Platform execute helpers — parse Assistant functionResults and call v1 execute routes",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "clean": "rimraf dist",
+    "prepublishOnly": "yarn clean && yarn build"
+  },
+  "keywords": [
+    "torque",
+    "actions",
+    "execute",
+    "integrator",
+    "sdk"
+  ],
+  "author": "Torque <hello@torque.fi>",
+  "license": "MIT",
+  "dependencies": {
+    "@torquefi/types": "file:../torque-types"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/node": "^20.0.0",
+    "rimraf": "^5.0.0",
+    "rollup": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}