@composio/client 0.1.0-alpha.15 → 0.1.0-alpha.16

package/src/resources/v3/cli.ts

@@ -0,0 +1,209 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Cli extends APIResource {
+  /**
+   * Generates a new CLI session with a random 6-character code. This endpoint is the
+   * first step in the CLI authentication flow, creating a session that can later be
+   * linked to a user account. The generated code is displayed to the user in the CLI
+   * and should be entered in the web interface to complete authentication.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v3.cli.createSession();
+   * ```
+   */
+  createSession(options?: RequestOptions): APIPromise<CliCreateSessionResponse> {
+    return this._client.post('/api/v3/cli/create-session', options);
+  }
+
+  /**
+   * Links a pending CLI session to the currently authenticated user. This is the
+   * final step in the CLI authentication flow, where the user enters the code in the
+   * web interface and their account is associated with the CLI session, allowing the
+   * CLI to act on their behalf.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v3.cli.linkSession({
+   *   id: 'ABC123',
+   * });
+   * ```
+   */
+  linkSession(body: CliLinkSessionParams, options?: RequestOptions): APIPromise<CliLinkSessionResponse> {
+    return this._client.put('/api/v3/cli/link-session', { body, ...options });
+  }
+
+  /**
+   * Retrieves the current state of a CLI session using either the session ID (UUID)
+   * or the 6-character code. This endpoint is used by both the CLI client to check
+   * if the session has been linked, and by the web interface to display session
+   * details before linking.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v3.cli.retrieveSession({
+   *   id: 'ABC123',
+   * });
+   * ```
+   */
+  retrieveSession(
+    query: CliRetrieveSessionParams,
+    options?: RequestOptions,
+  ): APIPromise<CliRetrieveSessionResponse> {
+    return this._client.get('/api/v3/cli/get-session', { query, ...options });
+  }
+}
+
+export interface CliCreateSessionResponse {
+  /**
+   * Unique identifier for the CLI session. UUID v4 format used for tracking and
+   * retrieval.
+   */
+  id: string;
+
+  /**
+   * The 6-character hexadecimal code used for CLI login
+   */
+  code: string;
+
+  /**
+   * The ISO timestamp when the session expires
+   */
+  expiresAt: string;
+
+  /**
+   * The current status of the session
+   */
+  status: 'pending' | 'linked';
+}
+
+export interface CliLinkSessionResponse {
+  /**
+   * The unique identifier for the CLI session
+   */
+  id: string;
+
+  /**
+   * Information about the linked account. Always present for successful responses
+   * from this endpoint.
+   */
+  account: CliLinkSessionResponse.Account;
+
+  /**
+   * The 6-character hexadecimal code used for CLI login
+   */
+  code: string;
+
+  /**
+   * The ISO timestamp when the session expires
+   */
+  expiresAt: string;
+
+  /**
+   * The current status of the session
+   */
+  status: 'pending' | 'linked';
+}
+
+export namespace CliLinkSessionResponse {
+  /**
+   * Information about the linked account. Always present for successful responses
+   * from this endpoint.
+   */
+  export interface Account {
+    /**
+     * The ID of the linked account
+     */
+    id: string;
+
+    /**
+     * The email address of the linked account
+     */
+    email: string;
+
+    /**
+     * The display name of the linked account
+     */
+    name: string;
+  }
+}
+
+export interface CliRetrieveSessionResponse {
+  /**
+   * The unique identifier for the CLI session
+   */
+  id: string;
+
+  /**
+   * Information about the linked account, if any. Null if the session status is
+   * "pending".
+   */
+  account: CliRetrieveSessionResponse.Account | null;
+
+  /**
+   * The 6-character hexadecimal code used for CLI login
+   */
+  code: string;
+
+  /**
+   * The ISO timestamp when the session expires
+   */
+  expiresAt: string;
+
+  /**
+   * The current status of the session
+   */
+  status: 'pending' | 'linked';
+}
+
+export namespace CliRetrieveSessionResponse {
+  /**
+   * Information about the linked account, if any. Null if the session status is
+   * "pending".
+   */
+  export interface Account {
+    /**
+     * The ID of the linked account
+     */
+    id: string;
+
+    /**
+     * The email address of the linked account
+     */
+    email: string;
+
+    /**
+     * The display name of the linked account
+     */
+    name: string;
+  }
+}
+
+export interface CliLinkSessionParams {
+  /**
+   * The CLI session ID or code to link to the current user
+   */
+  id: string;
+}
+
+export interface CliRetrieveSessionParams {
+  /**
+   * CLI session ID (UUID format) or 6-character code to check. Both formats are
+   * supported for flexibility in client implementations.
+   */
+  id: string;
+}
+
+export declare namespace Cli {
+  export {
+    type CliCreateSessionResponse as CliCreateSessionResponse,
+    type CliLinkSessionResponse as CliLinkSessionResponse,
+    type CliRetrieveSessionResponse as CliRetrieveSessionResponse,
+    type CliLinkSessionParams as CliLinkSessionParams,
+    type CliRetrieveSessionParams as CliRetrieveSessionParams,
+  };
+}

package/src/resources/v3/index.ts

@@ -0,0 +1,20 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Admin,
+  type AdminListConnectionsResponse,
+  type AdminRefreshAuthTokensResponse,
+  type AdminListConnectionsParams,
+  type AdminRefreshAuthTokensParams,
+} from './admin';
+export { Auth } from './auth/index';
+export {
+  Cli,
+  type CliCreateSessionResponse,
+  type CliLinkSessionResponse,
+  type CliRetrieveSessionResponse,
+  type CliLinkSessionParams,
+  type CliRetrieveSessionParams,
+} from './cli';
+export { Internal } from './internal/index';
+export { V3 } from './v3';

package/src/resources/v3/internal/action-execution.ts

@@ -0,0 +1,236 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class ActionExecution extends APIResource {
+  /**
+   * Get detailed execution log by ID
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.v3.internal.actionExecution.retrieveLog(
+   *     'id',
+   *   );
+   * ```
+   */
+  retrieveLog(id: string, options?: RequestOptions): APIPromise<ActionExecutionRetrieveLogResponse> {
+    return this._client.get(path`/api/v3/internal/action_execution/log/${id}`, options);
+  }
+
+  /**
+   * Search and retrieve action execution logs
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.v3.internal.actionExecution.searchLogs({
+   *     cursor: 0,
+   *   });
+   * ```
+   */
+  searchLogs(
+    body: ActionExecutionSearchLogsParams,
+    options?: RequestOptions,
+  ): APIPromise<ActionExecutionSearchLogsResponse> {
+    return this._client.post('/api/v3/internal/action_execution/logs', { body, ...options });
+  }
+}
+
+export interface ActionExecutionRetrieveLogResponse {
+  actionId: string;
+
+  actionLogId: string;
+
+  app: ActionExecutionRetrieveLogResponse.App;
+
+  connection: ActionExecutionRetrieveLogResponse.Connection;
+
+  endTime: number;
+
+  error: Record<string, unknown>;
+
+  executionMetadata: Record<string, unknown>;
+
+  payloadReceived: Record<string, unknown>;
+
+  response: Record<string, unknown>;
+
+  session: Record<string, unknown>;
+
+  startTime: number;
+
+  status: 'success' | 'error' | 'warning' | 'info';
+
+  steps: Array<ActionExecutionRetrieveLogResponse.Step>;
+
+  totalDuration: string;
+
+  version: string;
+}
+
+export namespace ActionExecutionRetrieveLogResponse {
+  export interface App {
+    icon: string;
+
+    name: string;
+
+    uniqueId: string;
+  }
+
+  export interface Connection {
+    entity: string;
+
+    id?: string;
+  }
+
+  export interface Step {
+    endTime: number;
+
+    message: string;
+
+    startTime: number;
+
+    status: 'success' | 'failure' | 'error';
+
+    totalDuration: number;
+
+    type: 'tool_execution' | 'fetch_connection_details';
+
+    logs?: Array<Step.Log>;
+
+    metadata?: Step.Metadata;
+  }
+
+  export namespace Step {
+    export interface Log {
+      level: string;
+
+      message: string;
+
+      request: Log.Request;
+
+      requestId: string;
+
+      response: Log.Response;
+
+      time: number;
+
+      type: 'network' | 'system';
+    }
+
+    export namespace Log {
+      export interface Request {
+        method: string;
+
+        url: string;
+
+        headers?: Record<string, string>;
+
+        json?: Record<string, unknown>;
+
+        params?: Record<string, unknown>;
+
+        timeout?: number;
+      }
+
+      export interface Response {
+        status: number;
+
+        time: string;
+      }
+    }
+
+    export interface Metadata {
+      encryption?: string;
+    }
+  }
+}
+
+export interface ActionExecutionSearchLogsResponse {
+  data: Array<ActionExecutionSearchLogsResponse.Data>;
+
+  nextCursor: number | null;
+}
+
+export namespace ActionExecutionSearchLogsResponse {
+  export interface Data {
+    id: string;
+
+    actionKey: string;
+
+    app: Data.App;
+
+    appKey: string;
+
+    connectedAccountId: string;
+
+    createdAt: number;
+
+    entityId: string;
+
+    executionTime: number;
+
+    minimalResponse: string;
+
+    status: 'success' | 'failed';
+  }
+
+  export namespace Data {
+    export interface App {
+      icon: string;
+
+      name: string;
+    }
+  }
+}
+
+export interface ActionExecutionSearchLogsParams {
+  /**
+   * cursor_that_can_be_used_to_paginate_through_the_logs
+   */
+  cursor: number | null;
+
+  /**
+   * whether_the_search_is_case_sensitive_or_not
+   */
+  case_sensitive?: boolean;
+
+  /**
+   * start_time_of_the_logs_in_epoch_time
+   */
+  from?: number;
+
+  /**
+   * number_of_logs_to_return
+   */
+  limit?: number;
+
+  search_params?: Array<ActionExecutionSearchLogsParams.SearchParam>;
+
+  /**
+   * end_time_of_the_logs_in_epoch_time
+   */
+  to?: number;
+}
+
+export namespace ActionExecutionSearchLogsParams {
+  export interface SearchParam {
+    field?: string;
+
+    operation?: string;
+
+    value?: string;
+  }
+}
+
+export declare namespace ActionExecution {
+  export {
+    type ActionExecutionRetrieveLogResponse as ActionExecutionRetrieveLogResponse,
+    type ActionExecutionSearchLogsResponse as ActionExecutionSearchLogsResponse,
+    type ActionExecutionSearchLogsParams as ActionExecutionSearchLogsParams,
+  };
+}

package/src/resources/v3/internal/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  ActionExecution,
+  type ActionExecutionRetrieveLogResponse,
+  type ActionExecutionSearchLogsResponse,
+  type ActionExecutionSearchLogsParams,
+} from './action-execution';
+export { Internal } from './internal';
+export { Trigger, type TriggerSearchLogsResponse, type TriggerSearchLogsParams } from './trigger';

package/src/resources/v3/internal/internal.ts

@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as ActionExecutionAPI from './action-execution';
+import {
+  ActionExecution,
+  ActionExecutionRetrieveLogResponse,
+  ActionExecutionSearchLogsParams,
+  ActionExecutionSearchLogsResponse,
+} from './action-execution';
+import * as TriggerAPI from './trigger';
+import { Trigger, TriggerSearchLogsParams, TriggerSearchLogsResponse } from './trigger';
+
+export class Internal extends APIResource {
+  trigger: TriggerAPI.Trigger = new TriggerAPI.Trigger(this._client);
+  actionExecution: ActionExecutionAPI.ActionExecution = new ActionExecutionAPI.ActionExecution(this._client);
+}
+
+Internal.Trigger = Trigger;
+Internal.ActionExecution = ActionExecution;
+
+export declare namespace Internal {
+  export {
+    Trigger as Trigger,
+    type TriggerSearchLogsResponse as TriggerSearchLogsResponse,
+    type TriggerSearchLogsParams as TriggerSearchLogsParams,
+  };
+
+  export {
+    ActionExecution as ActionExecution,
+    type ActionExecutionRetrieveLogResponse as ActionExecutionRetrieveLogResponse,
+    type ActionExecutionSearchLogsResponse as ActionExecutionSearchLogsResponse,
+    type ActionExecutionSearchLogsParams as ActionExecutionSearchLogsParams,
+  };
+}

package/src/resources/v3/internal/trigger.ts

@@ -0,0 +1,122 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Trigger extends APIResource {
+  /**
+   * Search and retrieve trigger event logs
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.v3.internal.trigger.searchLogs({
+   *     cursor: 'cursor',
+   *   });
+   * ```
+   */
+  searchLogs(body: TriggerSearchLogsParams, options?: RequestOptions): APIPromise<TriggerSearchLogsResponse> {
+    return this._client.post('/api/v3/internal/trigger/logs', { body, ...options });
+  }
+}
+
+export interface TriggerSearchLogsResponse {
+  nextCursor: string | null;
+
+  data?: Array<TriggerSearchLogsResponse.Data>;
+}
+
+export namespace TriggerSearchLogsResponse {
+  export interface Data {
+    id: string;
+
+    appName: string;
+
+    clientId: string;
+
+    connectionId: string;
+
+    createdAt: string;
+
+    entityId: string;
+
+    meta: Data.Meta;
+
+    status: string;
+
+    /**
+     * Log entity type (trigger or action)
+     */
+    type: 'trigger' | 'action';
+  }
+
+  export namespace Data {
+    export interface Meta {
+      id: string;
+
+      clientId: string;
+
+      connectionId: string;
+
+      createdAt: string;
+
+      provider: string;
+
+      /**
+       * Log entity type (trigger or action)
+       */
+      type: 'trigger' | 'action';
+
+      updatedAt: string;
+
+      triggerClientError?: string;
+
+      triggerClientPayload?: string;
+
+      triggerClientResponse?: string;
+
+      triggerName?: string;
+
+      triggerProviderPayload?: string;
+    }
+  }
+}
+
+export interface TriggerSearchLogsParams {
+  /**
+   * cursor that can be used to paginate through the logs
+   */
+  cursor: string | null;
+
+  entityId?: string;
+
+  integrationId?: string;
+
+  /**
+   * number of logs to return
+   */
+  limit?: number;
+
+  /**
+   * Search term to filter logs
+   */
+  search?: string;
+
+  /**
+   * Filter logs by their status level
+   */
+  status?: 'all' | 'success' | 'error';
+
+  /**
+   * Return logs from the last N time units
+   */
+  time?: '5m' | '30m' | '6h' | '1d' | '1w' | '1month' | '1y';
+}
+
+export declare namespace Trigger {
+  export {
+    type TriggerSearchLogsResponse as TriggerSearchLogsResponse,
+    type TriggerSearchLogsParams as TriggerSearchLogsParams,
+  };
+}

package/src/resources/v3/internal.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './internal/index';

package/src/resources/v3/v3.ts

@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AdminAPI from './admin';
+import {
+  Admin,
+  AdminListConnectionsParams,
+  AdminListConnectionsResponse,
+  AdminRefreshAuthTokensParams,
+  AdminRefreshAuthTokensResponse,
+} from './admin';
+import * as CliAPI from './cli';
+import {
+  Cli,
+  CliCreateSessionResponse,
+  CliLinkSessionParams,
+  CliLinkSessionResponse,
+  CliRetrieveSessionParams,
+  CliRetrieveSessionResponse,
+} from './cli';
+import * as AuthAPI from './auth/auth';
+import { Auth } from './auth/auth';
+import * as InternalAPI from './internal/internal';
+import { Internal } from './internal/internal';
+
+export class V3 extends APIResource {
+  auth: AuthAPI.Auth = new AuthAPI.Auth(this._client);
+  admin: AdminAPI.Admin = new AdminAPI.Admin(this._client);
+  cli: CliAPI.Cli = new CliAPI.Cli(this._client);
+  internal: InternalAPI.Internal = new InternalAPI.Internal(this._client);
+}
+
+V3.Auth = Auth;
+V3.Admin = Admin;
+V3.Cli = Cli;
+V3.Internal = Internal;
+
+export declare namespace V3 {
+  export { Auth as Auth };
+
+  export {
+    Admin as Admin,
+    type AdminListConnectionsResponse as AdminListConnectionsResponse,
+    type AdminRefreshAuthTokensResponse as AdminRefreshAuthTokensResponse,
+    type AdminListConnectionsParams as AdminListConnectionsParams,
+    type AdminRefreshAuthTokensParams as AdminRefreshAuthTokensParams,
+  };
+
+  export {
+    Cli as Cli,
+    type CliCreateSessionResponse as CliCreateSessionResponse,
+    type CliLinkSessionResponse as CliLinkSessionResponse,
+    type CliRetrieveSessionResponse as CliRetrieveSessionResponse,
+    type CliLinkSessionParams as CliLinkSessionParams,
+    type CliRetrieveSessionParams as CliRetrieveSessionParams,
+  };
+
+  export { Internal as Internal };
+}

package/src/resources/v3.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './v3/index';

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.15'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.16'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.15";
+export declare const VERSION = "0.1.0-alpha.16";
 //# sourceMappingURL=version.d.mts.map