@devries-cameron20 / composio-1 / commits / 99e10a99c
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

feat(ts/core): support redirect_url in connectedAccounts

jkomyno committed Jan 20, 2026 at 21:05 UTC 99e10a99cbcfaff89571bc1365ea18fc436e857c
3 files changed +108 -4
ts/packages/core/src/models/ConnectedAccounts.ts
+24 -2
@@ -8,6 +8,7 @@
8 import ComposioClient from '@composio/client';
9 import {
10 ConnectedAccountDeleteResponse,
11 + ConnectedAccountRefreshParams,
12 ConnectedAccountRefreshResponse,
13 ConnectedAccountUpdateStatusParams,
14 ConnectedAccountUpdateStatusResponse,
@@ -23,6 +24,8 @@ import {
24 CreateConnectedAccountLinkOptions,
25 CreateConnectedAccountLinkOptionsSchema,
26 ConnectedAccountStatuses,
27 + ConnectedAccountRefreshOptions,
28 + ConnectedAccountRefreshOptionsSchema,
29 } from '../types/connectedAccounts.types';
30 import { ConnectionRequest } from '../types/connectionRequest.types';
31 import { createConnectionRequest } from './ConnectionRequest';
@@ -370,8 +373,27 @@ export class ConnectedAccounts {
373 * const refreshedAccount = await composio.connectedAccounts.refresh('conn_abc123');
374 * ```
375 */
373 - async refresh(nanoid: string): Promise<ConnectedAccountRefreshResponse> {
374 - return this.client.connectedAccounts.refresh(nanoid);
376 + async refresh(
377 + nanoid: string,
378 + options?: ConnectedAccountRefreshOptions
379 + ): Promise<ConnectedAccountRefreshResponse> {
380 + let params: ConnectedAccountRefreshParams | undefined = undefined;
381 +
382 + if (options) {
383 + const parsedOptions = ConnectedAccountRefreshOptionsSchema.safeParse(options);
384 + if (!parsedOptions.success) {
385 + throw new ValidationError('Failed to parse connected account refresh options', {
386 + cause: parsedOptions.error,
387 + });
388 + }
389 +
390 + params = {
391 + body_redirect_url: parsedOptions.data.redirectUrl,
392 + validate_credentials: parsedOptions.data.validateCredentials,
393 + };
394 + }
395 +
396 + return this.client.connectedAccounts.refresh(nanoid, params);
397 }
398
399 /**
ts/packages/core/src/types/connectedAccounts.types.ts
+6
@@ -191,3 +191,9 @@ export const CreateConnectedAccountLinkResponseSchema = z.object({
191 export type CreateConnectedAccountLinkResponse = z.infer<
192 typeof CreateConnectedAccountLinkResponseSchema
193 >;
194 +
195 +export const ConnectedAccountRefreshOptionsSchema = z.object({
196 + redirectUrl: z.string().optional(),
197 + validateCredentials: z.boolean().optional(),
198 +});
199 +export type ConnectedAccountRefreshOptions = z.infer<typeof ConnectedAccountRefreshOptionsSchema>;
ts/packages/core/test/connectedAccounts/connectedAccounts.test.ts
+78 -2
@@ -441,7 +441,7 @@ describe('ConnectedAccounts', () => {
441 });
442
443 describe('refresh', () => {
444 - it('should refresh a connected account by nanoid', async () => {
444 + it('should refresh a connected account by nanoid without options', async () => {
445 const nanoid = 'conn_123';
446 const mockResponse = { id: nanoid, refreshed: true };
447
@@ -449,7 +449,83 @@ describe('ConnectedAccounts', () => {
449
450 const result = await connectedAccounts.refresh(nanoid);
451
452 - expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid);
452 + expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, undefined);
453 + expect(result).toEqual(mockResponse);
454 + });
455 +
456 + it('should refresh a connected account with redirectUrl option', async () => {
457 + const nanoid = 'conn_123';
458 + const redirectUrl = 'https://example.com/oauth/callback';
459 + const mockResponse = { id: nanoid, refreshed: true };
460 +
461 + extendedMockClient.connectedAccounts.refresh.mockResolvedValueOnce(mockResponse);
462 +
463 + const result = await connectedAccounts.refresh(nanoid, { redirectUrl });
464 +
465 + expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, {
466 + body_redirect_url: redirectUrl,
467 + validate_credentials: undefined,
468 + });
469 + expect(result).toEqual(mockResponse);
470 + });
471 +
472 + it('should refresh a connected account with validateCredentials option', async () => {
473 + const nanoid = 'conn_123';
474 + const mockResponse = { id: nanoid, refreshed: true };
475 +
476 + extendedMockClient.connectedAccounts.refresh.mockResolvedValueOnce(mockResponse);
477 +
478 + const result = await connectedAccounts.refresh(nanoid, { validateCredentials: true });
479 +
480 + expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, {
481 + body_redirect_url: undefined,
482 + validate_credentials: true,
483 + });
484 + expect(result).toEqual(mockResponse);
485 + });
486 +
487 + it('should refresh a connected account with both options', async () => {
488 + const nanoid = 'conn_123';
489 + const options = {
490 + redirectUrl: 'https://example.com/callback',
491 + validateCredentials: false,
492 + };
493 + const mockResponse = { id: nanoid, refreshed: true };
494 +
495 + extendedMockClient.connectedAccounts.refresh.mockResolvedValueOnce(mockResponse);
496 +
497 + const result = await connectedAccounts.refresh(nanoid, options);
498 +
499 + expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, {
500 + body_redirect_url: options.redirectUrl,
501 + validate_credentials: options.validateCredentials,
502 + });
503 + expect(result).toEqual(mockResponse);
504 + });
505 +
506 + it('should throw ValidationError for invalid options', async () => {
507 + const nanoid = 'conn_123';
508 + const invalidOptions = { redirectUrl: 123 };
509 +
510 + await expect(connectedAccounts.refresh(nanoid, invalidOptions as any)).rejects.toThrow(
511 + 'Failed to parse connected account refresh options'
512 + );
513 +
514 + expect(extendedMockClient.connectedAccounts.refresh).not.toHaveBeenCalled();
515 + });
516 +
517 + it('should handle empty options object gracefully', async () => {
518 + const nanoid = 'conn_123';
519 + const mockResponse = { id: nanoid, refreshed: true };
520 +
521 + extendedMockClient.connectedAccounts.refresh.mockResolvedValueOnce(mockResponse);
522 +
523 + const result = await connectedAccounts.refresh(nanoid, {});
524 +
525 + expect(extendedMockClient.connectedAccounts.refresh).toHaveBeenCalledWith(nanoid, {
526 + body_redirect_url: undefined,
527 + validate_credentials: undefined,
528 + });
529 expect(result).toEqual(mockResponse);
530 });
531 });