@composio/client 0.1.0-alpha.1 → 0.1.0-alpha.5

package/src/internal/qs/utils.ts

@@ -0,0 +1,265 @@
+import { RFC1738 } from './formats';
+import type { DefaultEncoder, Format } from './types';
+
+const has = Object.prototype.hasOwnProperty;
+const is_array = Array.isArray;
+
+const hex_table = (() => {
+  const array = [];
+  for (let i = 0; i < 256; ++i) {
+    array.push('%' + ((i < 16 ? '0' : '') + i.toString(16)).toUpperCase());
+  }
+
+  return array;
+})();
+
+function compact_queue<T extends Record<string, any>>(queue: Array<{ obj: T; prop: string }>) {
+  while (queue.length > 1) {
+    const item = queue.pop();
+    if (!item) continue;
+
+    const obj = item.obj[item.prop];
+
+    if (is_array(obj)) {
+      const compacted: unknown[] = [];
+
+      for (let j = 0; j < obj.length; ++j) {
+        if (typeof obj[j] !== 'undefined') {
+          compacted.push(obj[j]);
+        }
+      }
+
+      // @ts-ignore
+      item.obj[item.prop] = compacted;
+    }
+  }
+}
+
+function array_to_object(source: any[], options: { plainObjects: boolean }) {
+  const obj = options && options.plainObjects ? Object.create(null) : {};
+  for (let i = 0; i < source.length; ++i) {
+    if (typeof source[i] !== 'undefined') {
+      obj[i] = source[i];
+    }
+  }
+
+  return obj;
+}
+
+export function merge(
+  target: any,
+  source: any,
+  options: { plainObjects?: boolean; allowPrototypes?: boolean } = {},
+) {
+  if (!source) {
+    return target;
+  }
+
+  if (typeof source !== 'object') {
+    if (is_array(target)) {
+      target.push(source);
+    } else if (target && typeof target === 'object') {
+      if (
+        (options && (options.plainObjects || options.allowPrototypes)) ||
+        !has.call(Object.prototype, source)
+      ) {
+        target[source] = true;
+      }
+    } else {
+      return [target, source];
+    }
+
+    return target;
+  }
+
+  if (!target || typeof target !== 'object') {
+    return [target].concat(source);
+  }
+
+  let mergeTarget = target;
+  if (is_array(target) && !is_array(source)) {
+    // @ts-ignore
+    mergeTarget = array_to_object(target, options);
+  }
+
+  if (is_array(target) && is_array(source)) {
+    source.forEach(function (item, i) {
+      if (has.call(target, i)) {
+        const targetItem = target[i];
+        if (targetItem && typeof targetItem === 'object' && item && typeof item === 'object') {
+          target[i] = merge(targetItem, item, options);
+        } else {
+          target.push(item);
+        }
+      } else {
+        target[i] = item;
+      }
+    });
+    return target;
+  }
+
+  return Object.keys(source).reduce(function (acc, key) {
+    const value = source[key];
+
+    if (has.call(acc, key)) {
+      acc[key] = merge(acc[key], value, options);
+    } else {
+      acc[key] = value;
+    }
+    return acc;
+  }, mergeTarget);
+}
+
+export function assign_single_source(target: any, source: any) {
+  return Object.keys(source).reduce(function (acc, key) {
+    acc[key] = source[key];
+    return acc;
+  }, target);
+}
+
+export function decode(str: string, _: any, charset: string) {
+  const strWithoutPlus = str.replace(/\+/g, ' ');
+  if (charset === 'iso-8859-1') {
+    // unescape never throws, no try...catch needed:
+    return strWithoutPlus.replace(/%[0-9a-f]{2}/gi, unescape);
+  }
+  // utf-8
+  try {
+    return decodeURIComponent(strWithoutPlus);
+  } catch (e) {
+    return strWithoutPlus;
+  }
+}
+
+const limit = 1024;
+
+export const encode: (
+  str: any,
+  defaultEncoder: DefaultEncoder,
+  charset: string,
+  type: 'key' | 'value',
+  format: Format,
+) => string = (str, _defaultEncoder, charset, _kind, format: Format) => {
+  // This code was originally written by Brian White for the io.js core querystring library.
+  // It has been adapted here for stricter adherence to RFC 3986
+  if (str.length === 0) {
+    return str;
+  }
+
+  let string = str;
+  if (typeof str === 'symbol') {
+    string = Symbol.prototype.toString.call(str);
+  } else if (typeof str !== 'string') {
+    string = String(str);
+  }
+
+  if (charset === 'iso-8859-1') {
+    return escape(string).replace(/%u[0-9a-f]{4}/gi, function ($0) {
+      return '%26%23' + parseInt($0.slice(2), 16) + '%3B';
+    });
+  }
+
+  let out = '';
+  for (let j = 0; j < string.length; j += limit) {
+    const segment = string.length >= limit ? string.slice(j, j + limit) : string;
+    const arr = [];
+
+    for (let i = 0; i < segment.length; ++i) {
+      let c = segment.charCodeAt(i);
+      if (
+        c === 0x2d || // -
+        c === 0x2e || // .
+        c === 0x5f || // _
+        c === 0x7e || // ~
+        (c >= 0x30 && c <= 0x39) || // 0-9
+        (c >= 0x41 && c <= 0x5a) || // a-z
+        (c >= 0x61 && c <= 0x7a) || // A-Z
+        (format === RFC1738 && (c === 0x28 || c === 0x29)) // ( )
+      ) {
+        arr[arr.length] = segment.charAt(i);
+        continue;
+      }
+
+      if (c < 0x80) {
+        arr[arr.length] = hex_table[c];
+        continue;
+      }
+
+      if (c < 0x800) {
+        arr[arr.length] = hex_table[0xc0 | (c >> 6)]! + hex_table[0x80 | (c & 0x3f)];
+        continue;
+      }
+
+      if (c < 0xd800 || c >= 0xe000) {
+        arr[arr.length] =
+          hex_table[0xe0 | (c >> 12)]! + hex_table[0x80 | ((c >> 6) & 0x3f)] + hex_table[0x80 | (c & 0x3f)];
+        continue;
+      }
+
+      i += 1;
+      c = 0x10000 + (((c & 0x3ff) << 10) | (segment.charCodeAt(i) & 0x3ff));
+
+      arr[arr.length] =
+        hex_table[0xf0 | (c >> 18)]! +
+        hex_table[0x80 | ((c >> 12) & 0x3f)] +
+        hex_table[0x80 | ((c >> 6) & 0x3f)] +
+        hex_table[0x80 | (c & 0x3f)];
+    }
+
+    out += arr.join('');
+  }
+
+  return out;
+};
+
+export function compact(value: any) {
+  const queue = [{ obj: { o: value }, prop: 'o' }];
+  const refs = [];
+
+  for (let i = 0; i < queue.length; ++i) {
+    const item = queue[i];
+    // @ts-ignore
+    const obj = item.obj[item.prop];
+
+    const keys = Object.keys(obj);
+    for (let j = 0; j < keys.length; ++j) {
+      const key = keys[j]!;
+      const val = obj[key];
+      if (typeof val === 'object' && val !== null && refs.indexOf(val) === -1) {
+        queue.push({ obj: obj, prop: key });
+        refs.push(val);
+      }
+    }
+  }
+
+  compact_queue(queue);
+
+  return value;
+}
+
+export function is_regexp(obj: any) {
+  return Object.prototype.toString.call(obj) === '[object RegExp]';
+}
+
+export function is_buffer(obj: any) {
+  if (!obj || typeof obj !== 'object') {
+    return false;
+  }
+
+  return !!(obj.constructor && obj.constructor.isBuffer && obj.constructor.isBuffer(obj));
+}
+
+export function combine(a: any, b: any) {
+  return [].concat(a, b);
+}
+
+export function maybe_map<T>(val: T[], fn: (v: T) => T) {
+  if (is_array(val)) {
+    const mapped = [];
+    for (let i = 0; i < val.length; i += 1) {
+      mapped.push(fn(val[i]!));
+    }
+    return mapped;
+  }
+  return fn(val);
+}

package/src/internal/shims/getBuiltinModule.ts

@@ -29,11 +29,13 @@ export let getBuiltinModule: null | ((id: string) => object | undefined) = funct
       }
       const magicKey = Math.random() + '';
       let module: { BuiltinModule: any } | undefined;
+      let ObjectPrototype: {} = Blob;
+      for (let next; (next = Reflect.getPrototypeOf(ObjectPrototype)); ObjectPrototype = next);
       try {
         const kClone = Object.getOwnPropertySymbols(Blob.prototype).find(
           (e) => e.description?.includes('clone'),
         )!;
-        Object.defineProperty(Object.prototype, magicKey, {
+        Object.defineProperty(ObjectPrototype, magicKey, {
           get() {
             module = this;
             throw null;
@@ -50,7 +52,7 @@ export let getBuiltinModule: null | ((id: string) => object | undefined) = funct
           })([]),
         );
       } catch {}
-      delete (Object.prototype as any)[magicKey];
+      delete (ObjectPrototype as any)[magicKey];
       if (module) {
         getBuiltinModule = createFallbackGetBuiltinModule(module.BuiltinModule);
       } else {

package/src/internal/shims.ts

@@ -16,7 +16,7 @@ export function getDefaultFetch(): Fetch {
   }
 
   throw new Error(
-    '`fetch` is not defined as a global; Either pass `fetch` to the client, `new ComposioSDK({ fetch })` or polyfill the global, `globalThis.fetch = fetch`',
+    '`fetch` is not defined as a global; Either pass `fetch` to the client, `new Composio({ fetch })` or polyfill the global, `globalThis.fetch = fetch`',
   );
 }
 

package/src/internal/uploads.ts

@@ -1,6 +1,6 @@
 import { type RequestOptions } from './request-options';
 import type { FilePropertyBag, Fetch } from './builtin-types';
-import type { ComposioSDK } from '../client';
+import type { Composio } from '../client';
 import { type File, getFile } from './shims/file';
 import { ReadableStreamFrom } from './shims';
 
@@ -61,7 +61,7 @@ export const isAsyncIterable = (value: any): value is AsyncIterable<any> =>
  */
 export const maybeMultipartFormRequestOptions = async (
   opts: RequestOptions,
-  fetch: ComposioSDK | Fetch,
+  fetch: Composio | Fetch,
 ): Promise<RequestOptions> => {
   if (!hasUploadableValue(opts.body)) return opts;
 
@@ -72,7 +72,7 @@ type MultipartFormRequestOptions = Omit<RequestOptions, 'body'> & { body: unknow
 
 export const multipartFormRequestOptions = async (
   opts: MultipartFormRequestOptions,
-  fetch: ComposioSDK | Fetch,
+  fetch: Composio | Fetch,
 ): Promise<RequestOptions> => {
   return { ...opts, body: await createForm(opts.body, fetch) };
 };
@@ -85,7 +85,7 @@ const supportsFormDataMap = new WeakMap<Fetch, Promise<boolean>>();
  * This function detects if the fetch function provided supports the global FormData object to avoid
  * confusing error messages later on.
  */
-function supportsFormData(fetchObject: ComposioSDK | Fetch): Promise<boolean> {
+function supportsFormData(fetchObject: Composio | Fetch): Promise<boolean> {
   const fetch: Fetch = typeof fetchObject === 'function' ? fetchObject : (fetchObject as any).fetch;
   const cached = supportsFormDataMap.get(fetch);
   if (cached) return cached;
@@ -111,7 +111,7 @@ function supportsFormData(fetchObject: ComposioSDK | Fetch): Promise<boolean> {
 
 export const createForm = async <T = Record<string, unknown>>(
   body: T | undefined,
-  fetch: ComposioSDK | Fetch,
+  fetch: Composio | Fetch,
 ): Promise<FormData> => {
   if (!(await supportsFormData(fetch))) {
     throw new TypeError(

package/src/internal/utils/base64.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { ComposioSDKError } from '../../core/error';
+import { ComposioError } from '../../core/error';
 
 export const toBase64 = (data: string | Uint8Array | null | undefined): string => {
   if (!data) return '';
@@ -17,7 +17,7 @@ export const toBase64 = (data: string | Uint8Array | null | undefined): string =
     return btoa(String.fromCharCode.apply(null, data as any));
   }
 
-  throw new ComposioSDKError('Cannot generate base64 string; Expected `Buffer` or `btoa` to be defined');
+  throw new ComposioError('Cannot generate base64 string; Expected `Buffer` or `btoa` to be defined');
 };
 
 export const fromBase64 = (str: string): Uint8Array => {
@@ -33,5 +33,5 @@ export const fromBase64 = (str: string): Uint8Array => {
     );
   }
 
-  throw new ComposioSDKError('Cannot decode base64 string; Expected `Buffer` or `atob` to be defined');
+  throw new ComposioError('Cannot decode base64 string; Expected `Buffer` or `atob` to be defined');
 };

package/src/internal/utils/log.ts

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { hasOwn } from './values';
-import { type ComposioSDK } from '../../client';
+import { type Composio } from '../../client';
 import { RequestOptions } from '../request-options';
 
 type LogFn = (message: string, ...rest: unknown[]) => void;
@@ -24,7 +24,7 @@ const levelNumbers = {
 export const parseLogLevel = (
   maybeLevel: string | undefined,
   sourceName: string,
-  client: ComposioSDK,
+  client: Composio,
 ): LogLevel | undefined => {
   if (!maybeLevel) {
     return undefined;
@@ -60,7 +60,7 @@ const noopLogger = {
 
 let cachedLoggers = new WeakMap<Logger, [LogLevel, Logger]>();
 
-export function loggerFor(client: ComposioSDK): Logger {
+export function loggerFor(client: Composio): Logger {
   const logger = client.logger;
   const logLevel = client.logLevel ?? 'off';
   if (!logger) {

package/src/internal/utils/path.ts

@@ -1,4 +1,4 @@
-import { ComposioSDKError } from '../../core/error';
+import { ComposioError } from '../../core/error';
 
 /**
  * Percent-encode everything that isn't safe to have in a path without encoding safe chars.
@@ -51,9 +51,7 @@ export const createPathTagFunction = (pathEncoder = encodeURIPath) =>
         return acc + spaces + arrows;
       }, '');
 
-      throw new ComposioSDKError(
-        `Path parameters result in path with invalid segments:\n${path}\n${underline}`,
-      );
+      throw new ComposioError(`Path parameters result in path with invalid segments:\n${path}\n${underline}`);
     }
 
     return path;

package/src/internal/utils/values.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { ComposioSDKError } from '../../core/error';
+import { ComposioError } from '../../core/error';
 
 // https://url.spec.whatwg.org/#url-scheme-string
 const startsWithSchemeRegexp = /^[a-z][a-z0-9+.-]*:/i;
@@ -36,7 +36,7 @@ export function isObj(obj: unknown): obj is Record<string, unknown> {
 
 export const ensurePresent = <T>(value: T | null | undefined): T => {
   if (value == null) {
-    throw new ComposioSDKError(`Expected a value to be given but received ${value} instead.`);
+    throw new ComposioError(`Expected a value to be given but received ${value} instead.`);
   }
 
   return value;
@@ -44,10 +44,10 @@ export const ensurePresent = <T>(value: T | null | undefined): T => {
 
 export const validatePositiveInteger = (name: string, n: unknown): number => {
   if (typeof n !== 'number' || !Number.isInteger(n)) {
-    throw new ComposioSDKError(`${name} must be an integer`);
+    throw new ComposioError(`${name} must be an integer`);
   }
   if (n < 0) {
-    throw new ComposioSDKError(`${name} must be a positive integer`);
+    throw new ComposioError(`${name} must be a positive integer`);
   }
   return n;
 };
@@ -56,14 +56,14 @@ export const coerceInteger = (value: unknown): number => {
   if (typeof value === 'number') return Math.round(value);
   if (typeof value === 'string') return parseInt(value, 10);
 
-  throw new ComposioSDKError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+  throw new ComposioError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
 };
 
 export const coerceFloat = (value: unknown): number => {
   if (typeof value === 'number') return value;
   if (typeof value === 'string') return parseFloat(value);
 
-  throw new ComposioSDKError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+  throw new ComposioError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
 };
 
 export const coerceBoolean = (value: unknown): boolean => {

package/src/resources/action-execution.ts

@@ -139,7 +139,7 @@ export namespace ActionExecutionRetrieveLogResponse {
 
     startTime: number;
 
-    status: 'success' | 'error';
+    status: 'success' | 'failure' | 'error';
 
     totalDuration: number;
 

package/src/resources/cli.ts

@@ -0,0 +1,166 @@
+// 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 {
+  createSession(options?: RequestOptions): APIPromise<CliCreateSessionResponse> {
+    return this._client.post('/api/v3/cli/create-session', options);
+  }
+
+  linkSession(body: CliLinkSessionParams, options?: RequestOptions): APIPromise<CliLinkSessionResponse> {
+    return this._client.put('/api/v3/cli/link-session', { body, ...options });
+  }
+
+  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
+   */
+  id: string;
+
+  /**
+   * Temporary code to use for CLI login
+   */
+  code: string;
+
+  /**
+   * Expiration time of the session
+   */
+  expiresAt: string;
+
+  /**
+   * Current status of the session
+   */
+  status: 'pending' | 'linked';
+}
+
+export interface CliLinkSessionResponse {
+  /**
+   * Unique identifier for the CLI session
+   */
+  id: string;
+
+  /**
+   * Information about the linked account
+   */
+  account: CliLinkSessionResponse.Account;
+
+  /**
+   * Temporary code used for CLI login
+   */
+  code: string;
+
+  /**
+   * Expiration time of the session
+   */
+  expiresAt: string;
+
+  /**
+   * Current status of the session
+   */
+  status: 'pending' | 'linked';
+}
+
+export namespace CliLinkSessionResponse {
+  /**
+   * Information about the linked account
+   */
+  export interface Account {
+    /**
+     * ID of the linked account
+     */
+    id: string;
+
+    /**
+     * Email of the linked account
+     */
+    email: string;
+
+    /**
+     * Name of the linked account
+     */
+    name: string;
+  }
+}
+
+export interface CliRetrieveSessionResponse {
+  /**
+   * Unique identifier for the CLI session
+   */
+  id: string;
+
+  /**
+   * Information about the linked account, if any
+   */
+  account: CliRetrieveSessionResponse.Account | null;
+
+  /**
+   * Temporary code used for CLI login
+   */
+  code: string;
+
+  /**
+   * Expiration time of the session
+   */
+  expiresAt: string;
+
+  /**
+   * Current status of the session
+   */
+  status: 'pending' | 'linked';
+}
+
+export namespace CliRetrieveSessionResponse {
+  /**
+   * Information about the linked account, if any
+   */
+  export interface Account {
+    /**
+     * ID of the linked account
+     */
+    id: string;
+
+    /**
+     * Email of the linked account
+     */
+    email: string;
+
+    /**
+     * Name of the linked account
+     */
+    name: string;
+  }
+}
+
+export interface CliLinkSessionParams {
+  /**
+   * CLI session ID or code to link
+   */
+  id: string;
+}
+
+export interface CliRetrieveSessionParams {
+  /**
+   * CLI session ID or code to check
+   */
+  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/index.ts

@@ -20,6 +20,14 @@ export {
   type AuthConfigListParams,
   type AuthConfigUpdateStatusParams,
 } from './auth-configs';
+export {
+  Cli,
+  type CliCreateSessionResponse,
+  type CliLinkSessionResponse,
+  type CliRetrieveSessionResponse,
+  type CliLinkSessionParams,
+  type CliRetrieveSessionParams,
+} from './cli';
 export {
   ConnectedAccounts,
   type ConnectedAccountCreateResponse,
@@ -32,6 +40,20 @@ export {
   type ConnectedAccountListParams,
   type ConnectedAccountUpdateStatusParams,
 } from './connected-accounts';
+export {
+  Mcp,
+  type McpCreateResponse,
+  type McpRetrieveResponse,
+  type McpUpdateResponse,
+  type McpListResponse,
+  type McpDeleteResponse,
+  type McpRetrieveAppResponse,
+  type McpValidateResponse,
+  type McpCreateParams,
+  type McpUpdateParams,
+  type McpListParams,
+  type McpValidateParams,
+} from './mcp/mcp';
 export { Org } from './org/org';
 export {
   TeamMembers,