diff --git a/README.md b/README.md index 51cfab1..30bf1be 100644 --- a/README.md +++ b/README.md @@ -79,51 +79,54 @@ fintoc logout # Remove stored credentials Resources follow the pattern `fintoc [v2] [args] [flags]`. Actions that act on a single object take its ID as the first argument. -| Resource | Actions | -| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -| `payment_intents` | create, get, list, expire | -| `webhook_endpoints` | create, get, list, update, delete, test | -| `charges` | create, get, list, update, cancel | -| `subscriptions` | get, list | -| `links` | get, list, update, delete, exchange | -| `checkout_sessions` | create, get, expire | -| `organizations` | create | -| `api_keys` | list | -| `refunds` | create, get, list, cancel, voucher_url | -| `subscription_intents` | create, get, list | -| `payment_links` | create, get, list, cancel | -| `disputes` | get, list, submit_for_review, create_document | -| `accounts` | get, list | -| `movements` | get, list | -| `invoices` | get, list | -| `tax_returns` | get, list | -| `refresh_intents` | create, get, list | -| `payouts` | get, list, resources | -| `institutions` | list | -| `link_intents` | create | -| `tax_statements` | get, list | -| `v2 transfers` | create, get, list, receipt, return | -| `v2 accounts` | create, get, list, update | -| `v2 account_verifications` | create, get, list | -| `v2 account_numbers` | create, get, list, update, delete | -| `v2 movements` | get, list | -| `v2 checkout_sessions` | create, get, list, expire | -| `v2 customers` | create, get, list | -| `v2 entities` | create, get, list, settlement_account | -| `v2 onboardings` | create, get, list, submit, upload_document, add_document, delete_document, upload_shareholder_document, upload_legal_representative_document | -| `v2 payment_intents` | create, get, list, cancel, voucher_url, check_eligibility | -| `v2 payment_methods` | create, get, list, cancel, mandate_document | -| `v2 products` | create, get, list, update | -| `v2 subscriptions` | create, get, list, update, cancel, detach_payment_method | -| `v2 invoices` | create, get, list, update, finalize, pay, void, mark_uncollectible, add_lines, remove_lines | -| `v2 account_statements` | list | -| `v2 recipients` | create, get, list, update, delete | -| `v2 transfer_batches` | create, get, list | -| `v2 events` | get, list | -| `v2 setup_intents` | get | -| `v2 subscription_items` | create, update, delete | -| `v2 invoice_lines` | update | -| `v2 simulate` | receive_transfer | +| Resource | Actions | +| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | +| `payment_intents` | create, get, list, expire | +| `webhook_endpoints` | create, get, list, update, delete, test | +| `charges` | create, get, list, update, cancel | +| `subscriptions` | get, list | +| `links` | get, list, update, delete, exchange | +| `checkout_sessions` | create, get, expire | +| `organizations` | create | +| `api_keys` | list | +| `refunds` | create, get, list, cancel, voucher_url | +| `subscription_intents` | create, get, list | +| `payment_links` | create, get, list, cancel | +| `disputes` | get, list, submit_for_review, create_document | +| `accounts` | get, list | +| `movements` | get, list | +| `invoices` | get, list | +| `tax_returns` | get, list | +| `refresh_intents` | create, get, list | +| `payouts` | get, list, resources | +| `institutions` | list | +| `link_intents` | create | +| `tax_statements` | get, list | +| `v2 transfers` | create, get, list, receipt, return | +| `v2 accounts` | create, get, list, update, certificate | +| `v2 account_verifications` | create, get, list | +| `v2 account_numbers` | create, get, list, update, delete, certificate | +| `v2 movements` | get, list | +| `v2 checkout_sessions` | create, get, list, expire, confirm | +| `v2 customers` | create, get, list | +| `v2 entities` | create, get, list, settlement_account | +| `v2 onboardings` | create, get, list, submit, upload_document, add_document, delete_document, upload_shareholder_document, upload_legal_representative_document | +| `v2 payment_intents` | create, get, list, cancel, voucher_url, check_eligibility | +| `v2 payment_methods` | create, get, list, cancel, mandate_document | +| `v2 products` | create, get, list, update | +| `v2 subscriptions` | create, get, list, update, cancel, detach_payment_method | +| `v2 invoices` | create, get, list, update, finalize, pay, void, mark_uncollectible, add_lines, remove_lines | +| `v2 account_statements` | list | +| `v2 recipients` | create, get, list, update, delete | +| `v2 transfer_batches` | create, get, list | +| `v2 events` | get, list | +| `v2 setup_intents` | get | +| `v2 subscription_items` | create, update, delete | +| `v2 invoice_lines` | update | +| `v2 simulate` | receive_transfer | +| `v2 crossborder_beneficiaries` | create, get, list, delete | +| `v2 crossborder_quotes` | create, get | +| `v2 crossborder_transfers` | create, get, list | `organizations create` preserves the published `--products ` and `--metadata ` flags. Updating organizations requires a future SDK release; fintoc 1.31.0 only supports creation. diff --git a/package-lock.json b/package-lock.json index 773ab44..9aab59a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -12,7 +12,7 @@ "@inquirer/prompts": "^8.4.2", "commander": "^14.0.3", "es-toolkit": "^1.46.1", - "fintoc": "^1.31.0", + "fintoc": "^1.33.0", "smol-toml": "^1.6.1", "ws": "^8.20.0", "zod": "^4.4.3" @@ -4473,9 +4473,9 @@ } }, "node_modules/fintoc": { - "version": "1.31.0", - "resolved": "https://registry.npmjs.org/fintoc/-/fintoc-1.31.0.tgz", - "integrity": "sha512-TX4g9VXwtawgkS2zVzy4a1XIbeVPXr69ZCBfbj3jiieOC/deS40JxR0s+TTqsFHKQj94IouqVESwqznnnw89SQ==", + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/fintoc/-/fintoc-1.33.0.tgz", + "integrity": "sha512-+R/z2Rdv/X3PN2aWBaw0vWhJUC3FLSggcioRs9RSQ5K6QyBDlm4kX8nMwEi1eooHZoIyLSKbo79FmD9GVIy1RA==", "license": "BSD-3-Clause", "dependencies": { "@types/node": "^22.15.18", diff --git a/package.json b/package.json index 294d6de..372d65c 100644 --- a/package.json +++ b/package.json @@ -34,7 +34,7 @@ "@inquirer/prompts": "^8.4.2", "commander": "^14.0.3", "es-toolkit": "^1.46.1", - "fintoc": "^1.31.0", + "fintoc": "^1.33.0", "smol-toml": "^1.6.1", "ws": "^8.20.0", "zod": "^4.4.3" diff --git a/src/resources/__tests__/registry.test.ts b/src/resources/__tests__/registry.test.ts index 4c822eb..d1daea1 100644 --- a/src/resources/__tests__/registry.test.ts +++ b/src/resources/__tests__/registry.test.ts @@ -6,8 +6,8 @@ const find = (name: string, namespace: 'v1' | 'v2') => describe('resource registry', () => { describe('schema validation', () => { - test('contains all 43 resources', () => { - expect(resources).toHaveLength(43) + test('contains all 46 resources', () => { + expect(resources).toHaveLength(46) const names = resources.map((r) => r.name) expect(names).toEqual([ @@ -54,6 +54,9 @@ describe('resource registry', () => { 'subscription_items', 'invoice_lines', 'simulate', + 'crossborder_beneficiaries', + 'crossborder_quotes', + 'crossborder_transfers', ]) }) @@ -209,6 +212,9 @@ describe('resource registry', () => { 'subscription_items', 'invoice_lines', 'simulate', + 'crossborder_beneficiaries', + 'crossborder_quotes', + 'crossborder_transfers', ]) }) }) @@ -383,6 +389,22 @@ describe('resource registry', () => { ['products', 'v2', ['name']], ['recipients', 'v2', ['entity-id', 'account-number', 'holder-name']], ['link_intents', 'v1', ['country', 'holder-type', 'product']], + [ + 'crossborder_beneficiaries', + 'v2', + [ + 'holder-type', + 'account-identifier', + 'routing-number', + 'bank-name', + 'address-street-line1', + 'address-city', + 'address-state', + 'address-postal-code', + ], + ], + ['crossborder_quotes', 'v2', ['direction', 'source-amount']], + ['crossborder_transfers', 'v2', ['quote-id']], ] as const)('%s (%s) required create flags', (name, namespace, expected) => { const resource = find(name, namespace) expect( @@ -425,6 +447,32 @@ describe('resource registry', () => { ).toEqual(['entity-id']) }) + test.each([ + [ + 'crossborder_beneficiaries', + 'crossborder.beneficiaries', + ['create', 'get', 'list', 'delete'], + ], + ['crossborder_quotes', 'crossborder.quotes', ['create', 'get']], + ['crossborder_transfers', 'crossborder.transfers', ['create', 'get', 'list']], + ] as const)('%s uses nested sdkMethod %s', (name, sdkMethod, verbs) => { + const resource = find(name, 'v2') + expect(resource.sdkMethod).toBe(sdkMethod) + expect(resource.verbs).toEqual(verbs) + }) + + test.each(['accounts', 'account_numbers'])('v2 %s exposes certificate as a read', (name) => { + const certificate = find(name, 'v2').actions!.find((a) => a.name === 'certificate')! + expect(certificate.sdkMethod).toBe('certificate') + expect(certificate.kind).toBe('read') + }) + + test('v2 checkout_sessions confirm is an idempotent write', () => { + const confirm = find('checkout_sessions', 'v2').actions!.find((a) => a.name === 'confirm')! + expect(confirm.sdkMethod).toBe('confirm') + expect(confirm.idempotencyKey).toBe(true) + }) + test('account_statements uses nested sdkMethod, list only, requires account-id', () => { const statements = find('account_statements', 'v2') expect(statements.sdkMethod).toBe('accounts.accountStatements') diff --git a/src/resources/registry.ts b/src/resources/registry.ts index 8eec5a9..e7565fc 100644 --- a/src/resources/registry.ts +++ b/src/resources/registry.ts @@ -381,6 +381,14 @@ export const resources: ResourceDef[] = [ description: 'Description of the account (up to 40 characters)', }, ], + actions: [ + { + name: 'certificate', + sdkMethod: 'certificate', + description: 'Get the certificate download URL of an account (Mexico only, live mode)', + kind: 'read', + }, + ], }, { name: 'webhook_endpoints', @@ -893,6 +901,15 @@ export const resources: ResourceDef[] = [ description: 'Metadata to attach', }, ], + actions: [ + { + name: 'certificate', + sdkMethod: 'certificate', + description: + 'Get the certificate download URL of an account number (Mexico only, live mode)', + kind: 'read', + }, + ], }, { name: 'movements', @@ -1810,6 +1827,13 @@ export const resources: ResourceDef[] = [ confirm: true, successMessage: "{resource} '{id}' expired", }, + { + name: 'confirm', + idempotencyKey: true, + sdkMethod: 'confirm', + description: 'Charge the card submitted to a checkout session with ui-mode fields', + successMessage: "{resource} '{id}' confirmed", + }, ], }, { @@ -3357,6 +3381,179 @@ export const resources: ResourceDef[] = [ }, ], }, + { + name: 'crossborder_beneficiaries', + displayName: 'crossborder beneficiary', + pluralDisplayName: 'crossborder beneficiaries', + description: 'Manage beneficiaries of international transfers (delete archives them)', + cliCommand: 'crossborder_beneficiaries', + sdkMethod: 'crossborder.beneficiaries', + sdkNamespace: 'v2', + verbs: ['create', 'get', 'list', 'delete'], + priorityColumns: ['id', 'holder_type', 'bank_name', 'account_last4', 'archived_at'], + createFlags: [ + { + name: 'holder-type', + type: 'string', + required: true, + description: 'Type of the account holder (business, individual)', + }, + { + name: 'business-name', + type: 'string', + description: 'Name of the business that holds the account (required for business)', + }, + { + name: 'first-name', + type: 'string', + description: 'First name of the person that holds the account (required for individual)', + }, + { + name: 'last-name', + type: 'string', + description: 'Last name of the person that holds the account (required for individual)', + }, + { + name: 'account-identifier', + type: 'string', + required: true, + description: 'Account number of the beneficiary (4 to 17 digits)', + }, + { + name: 'routing-number', + type: 'string', + required: true, + description: 'Nine-digit ABA routing number of the bank', + }, + { + name: 'bank-name', + type: 'string', + required: true, + description: 'Name of the bank that holds the account', + }, + { + name: 'address-street-line1', + type: 'string', + required: true, + nestedPath: 'address.street_line1', + description: 'First line of the account holder street address, in the United States', + }, + { + name: 'address-street-line2', + type: 'string', + nestedPath: 'address.street_line2', + description: 'Second line of the account holder street address', + }, + { + name: 'address-city', + type: 'string', + required: true, + nestedPath: 'address.city', + description: 'City of the account holder address', + }, + { + name: 'address-state', + type: 'string', + required: true, + nestedPath: 'address.state', + description: 'State of the account holder address (e.g., NY)', + }, + { + name: 'address-postal-code', + type: 'string', + required: true, + nestedPath: 'address.postal_code', + description: 'Postal code of the account holder address', + }, + { + name: 'address-country', + type: 'string', + nestedPath: 'address.country', + description: 'Country of the account holder address (US)', + }, + { + name: 'account-scheme', + type: 'string', + description: 'Scheme of the account (us_aba)', + }, + { + name: 'country', + type: 'string', + description: 'Country of the account (US)', + }, + { + name: 'currency', + type: 'string', + description: 'Currency of the account (USD)', + }, + ], + listFlags: [...CURSOR_FLAGS], + }, + { + name: 'crossborder_quotes', + displayName: 'crossborder quote', + description: 'Manage exchange rate quotes for international transfers', + cliCommand: 'crossborder_quotes', + sdkMethod: 'crossborder.quotes', + sdkNamespace: 'v2', + verbs: ['create', 'get'], + priorityColumns: ['id', 'direction', 'source_amount', 'target_amount', 'status', 'expires_at'], + createFlags: [ + { + name: 'direction', + type: 'string', + required: true, + description: 'Currencies to convert (mx_to_usd, usd_to_mx)', + }, + { + name: 'source-amount', + type: 'integer', + required: true, + description: 'Amount to convert in the smallest unit of the source currency', + }, + ], + }, + { + name: 'crossborder_transfers', + displayName: 'crossborder transfer', + description: 'Manage international transfers', + cliCommand: 'crossborder_transfers', + sdkMethod: 'crossborder.transfers', + sdkNamespace: 'v2', + verbs: ['create', 'get', 'list'], + priorityColumns: ['id', 'direction', 'source_amount', 'target_amount', 'status', 'created_at'], + createFlags: [ + { + name: 'quote-id', + type: 'string', + required: true, + description: 'ID of the crossborder quote to accept', + }, + { + name: 'beneficiary-id', + type: 'string', + description: 'ID of the active beneficiary that receives the funds (mx_to_usd only)', + }, + { + name: 'reference', + type: 'string', + description: 'Reference of the transfer (up to 140 characters)', + }, + ], + listFlags: [ + ...CURSOR_FLAGS, + { + name: 'status', + type: 'string[]', + description: 'Filter by status (pending_funds, in_progress, succeeded, canceled, failed)', + }, + { + name: 'direction', + type: 'string', + description: 'Filter by direction (mx_to_usd, usd_to_mx)', + }, + ], + }, ] export const v1Resources = resources.filter((r) => r.sdkNamespace === 'v1')