sendblue 0.1.0-alpha.1

package/src/resources/groups.ts

@@ -0,0 +1,102 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as MessagesAPI from './messages';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Groups extends APIResource {
+  /**
+   * Add or manage participants in a group chat (beta feature)
+   *
+   * @example
+   * ```ts
+   * const response = await client.groups.modify({
+   *   group_id: 'group_123456',
+   *   modify_type: 'add_recipient',
+   *   number: '+19998887777',
+   * });
+   * ```
+   */
+  modify(body: GroupModifyParams, options?: RequestOptions): APIPromise<GroupModifyResponse> {
+    return this._client.post('/api/modify-group', { body, ...options });
+  }
+
+  /**
+   * Send a message to a group of recipients (beta feature)
+   *
+   * @example
+   * ```ts
+   * const messageResponse = await client.groups.sendMessage({
+   *   content: 'Hello, everyone!',
+   *   from_number: '+19998887777',
+   * });
+   * ```
+   */
+  sendMessage(
+    body: GroupSendMessageParams,
+    options?: RequestOptions,
+  ): APIPromise<MessagesAPI.MessageResponse> {
+    return this._client.post('/api/send-group-message', { body, ...options });
+  }
+}
+
+export interface GroupModifyResponse {
+  message?: string;
+
+  status?: string;
+}
+
+export interface GroupModifyParams {
+  /**
+   * Group identifier
+   */
+  group_id: string;
+
+  /**
+   * Type of modification to perform
+   */
+  modify_type: 'add_recipient';
+
+  /**
+   * Phone number to add/modify in E.164 format
+   */
+  number: string;
+}
+
+export interface GroupSendMessageParams {
+  /**
+   * Message text content
+   */
+  content: string;
+
+  /**
+   * **REQUIRED** - The phone number to send from. Must be one of your registered
+   * Sendblue phone numbers in E.164 format. Without this parameter, the message will
+   * fail to send.
+   */
+  from_number: string;
+
+  /**
+   * Unique identifier for an existing group
+   */
+  group_id?: string;
+
+  /**
+   * URL of media file to send
+   */
+  media_url?: string;
+
+  /**
+   * Array of recipient phone numbers in E.164 format
+   */
+  numbers?: Array<string>;
+}
+
+export declare namespace Groups {
+  export {
+    type GroupModifyResponse as GroupModifyResponse,
+    type GroupModifyParams as GroupModifyParams,
+    type GroupSendMessageParams as GroupSendMessageParams,
+  };
+}

package/src/resources/index.ts

@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Groups,
+  type GroupModifyResponse,
+  type GroupModifyParams,
+  type GroupSendMessageParams,
+} from './groups';
+export { Lookups, type LookupLookupNumberResponse, type LookupLookupNumberParams } from './lookups';
+export { MediaObjects, type MediaObjectUploadResponse, type MediaObjectUploadParams } from './media-objects';
+export {
+  Messages,
+  type MessageContent,
+  type MessageResponse,
+  type MessageRetrieveResponse,
+  type MessageListResponse,
+  type MessageListParams,
+  type MessageGetStatusParams,
+  type MessageSendParams,
+} from './messages';
+export {
+  TypingIndicators,
+  type TypingIndicatorSendResponse,
+  type TypingIndicatorSendParams,
+} from './typing-indicators';

package/src/resources/lookups.ts

@@ -0,0 +1,44 @@
+// 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 Lookups extends APIResource {
+  /**
+   * Determine if a phone number supports iMessage or SMS. Useful for checking if a
+   * number is an iPhone, if it is real, or which provider to use.
+   */
+  lookupNumber(
+    query: LookupLookupNumberParams,
+    options?: RequestOptions,
+  ): APIPromise<LookupLookupNumberResponse> {
+    return this._client.get('/api/evaluate-service', { query, ...options });
+  }
+}
+
+export interface LookupLookupNumberResponse {
+  /**
+   * The number you evaluated in E.164 format
+   */
+  number?: string;
+
+  /**
+   * The service the number supports
+   */
+  service?: 'iMessage' | 'SMS';
+}
+
+export interface LookupLookupNumberParams {
+  /**
+   * The number you want to evaluate in E.164 format
+   */
+  number: string;
+}
+
+export declare namespace Lookups {
+  export {
+    type LookupLookupNumberResponse as LookupLookupNumberResponse,
+    type LookupLookupNumberParams as LookupLookupNumberParams,
+  };
+}

package/src/resources/media-objects.ts

@@ -0,0 +1,43 @@
+// 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 MediaObjects extends APIResource {
+  /**
+   * Upload a media file to Sendblue's CDN for use in messages
+   *
+   * @example
+   * ```ts
+   * const response = await client.mediaObjects.upload({
+   *   media_url: 'https://example.com/image.jpg',
+   * });
+   * ```
+   */
+  upload(body: MediaObjectUploadParams, options?: RequestOptions): APIPromise<MediaObjectUploadResponse> {
+    return this._client.post('/api/upload-media-object', { body, ...options });
+  }
+}
+
+export interface MediaObjectUploadResponse {
+  mediaObjectId?: string;
+
+  message?: string;
+
+  status?: string;
+}
+
+export interface MediaObjectUploadParams {
+  /**
+   * URL of the media file to upload
+   */
+  media_url: string;
+}
+
+export declare namespace MediaObjects {
+  export {
+    type MediaObjectUploadResponse as MediaObjectUploadResponse,
+    type MediaObjectUploadParams as MediaObjectUploadParams,
+  };
+}