@stack0/sdk 0.2.9 → 0.3.0

package/dist/index.d.mts

@@ -1,15 +1,536 @@
 import { Mail } from './mail/index.mjs';
 export { Attachment, EmailAddress, EmailRecipient, GetEmailResponse, SendEmailRequest, SendEmailResponse, Stack0Error } from './mail/index.mjs';
 import { CDN } from './cdn/index.mjs';
-export { Asset, AssetStatus, AssetType, ConfirmUploadRequest, ConfirmUploadResponse, CreateFolderRequest, DeleteAssetRequest, DeleteAssetsRequest, DeleteAssetsResponse, Folder, FolderTreeNode, GetAssetRequest, GetFolderTreeRequest, GetTransformUrlRequest, GetTransformUrlResponse, ListAssetsRequest, ListAssetsResponse, MoveAssetsRequest, MoveAssetsResponse, TransformOptions, UpdateAssetRequest, UploadUrlRequest, UploadUrlResponse } from './cdn/index.mjs';
+export { Asset, AssetStatus, AssetType, ConfirmUploadRequest, ConfirmUploadResponse, CreateFolderRequest, DeleteAssetRequest, DeleteAssetsRequest, DeleteAssetsResponse, ExtractAudioRequest, ExtractAudioResponse, Folder, FolderTreeNode, GetAssetRequest, GetFolderTreeRequest, GetTransformUrlRequest, GetTransformUrlResponse, ListAssetsRequest, ListAssetsResponse, ListJobsRequest, ListJobsResponse, MoveAssetsRequest, MoveAssetsResponse, StreamingUrls, ThumbnailRequest, ThumbnailResponse, TranscodeJob, TranscodeVideoRequest, TranscodingStatus, TransformOptions, TrimOptions, UpdateAssetRequest, UploadUrlRequest, UploadUrlResponse, VideoCodec, VideoOutputFormat, VideoQuality, VideoVariant, WatermarkOptions } from './cdn/index.mjs';
 import { Screenshots } from './screenshots/index.mjs';
 export { BatchScreenshotJob, Clip, CreateBatchScreenshotsRequest, CreateScreenshotRequest, CreateScreenshotResponse, CreateScreenshotScheduleRequest, DeviceType, GetScreenshotRequest, ListScreenshotsRequest, ListScreenshotsResponse, ResourceType, Screenshot, ScreenshotBatchJobsResponse, ScreenshotFormat, ScreenshotSchedule, ScreenshotSchedulesResponse, ScreenshotStatus, UpdateScreenshotScheduleRequest } from './screenshots/index.mjs';
 import { Extraction } from './extraction/index.mjs';
 export { BatchExtractionJob, CreateBatchExtractionsRequest, CreateExtractionRequest, CreateExtractionResponse, CreateExtractionScheduleRequest, ExtractionBatchJobsResponse, ExtractionMode, ExtractionResult, ExtractionSchedule, ExtractionSchedulesResponse, ExtractionStatus, ExtractionUsage, GetExtractionRequest, GetUsageRequest, ListExtractionsRequest, ListExtractionsResponse, PageMetadata, UpdateExtractionScheduleRequest } from './extraction/index.mjs';
 import { Webdata } from './webdata/index.mjs';
-import { H as HttpClientConfig } from './http-client-Wr9lXo9_.mjs';
+import { H as HttpClient, a as HttpClientConfig } from './http-client-DjrRWvXA.mjs';
 export { B as BatchJobStatus, C as CreateBatchResponse, c as CreateScheduleResponse, E as Environment, G as GetBatchJobRequest, a as GetScheduleRequest, L as ListBatchJobsRequest, b as ListSchedulesRequest, S as ScheduleFrequency } from './shared-types-B0PyC7cF.mjs';
 
+/**
+ * Stack0 Integrations SDK Types
+ */
+interface PaginatedResult<T> {
+    data: T[];
+    nextCursor?: string;
+    hasMore: boolean;
+    totalCount?: number;
+}
+interface ListOptions {
+    cursor?: string;
+    limit?: number;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+    filters?: Record<string, unknown>;
+}
+type ConnectorCategory = "crm" | "storage" | "communication" | "productivity";
+interface Connector {
+    id: string;
+    slug: string;
+    name: string;
+    description?: string;
+    category: ConnectorCategory;
+    iconUrl?: string;
+    websiteUrl?: string;
+    isEnabled: boolean;
+}
+interface Connection {
+    id: string;
+    connectorId: string;
+    connectorSlug: string;
+    name?: string;
+    status: "pending" | "connected" | "error" | "disconnected";
+    externalAccountId?: string;
+    externalAccountName?: string;
+    lastSyncedAt?: Date;
+    lastUsedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface Address {
+    type?: "work" | "home" | "billing" | "shipping" | "headquarters" | "other";
+    street?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+}
+interface PhoneNumber {
+    type?: "work" | "home" | "mobile" | "fax" | "other";
+    number: string;
+    isPrimary?: boolean;
+}
+interface IntegrationEmailAddress {
+    type?: "work" | "personal" | "other";
+    email: string;
+    isPrimary?: boolean;
+}
+interface Contact {
+    id: string;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    emails?: IntegrationEmailAddress[];
+    phone?: string;
+    phones?: PhoneNumber[];
+    title?: string;
+    department?: string;
+    companyId?: string;
+    companyName?: string;
+    addresses?: Address[];
+    website?: string;
+    description?: string;
+    ownerId?: string;
+    customFields?: Record<string, unknown>;
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface CreateContactInput {
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    emails?: IntegrationEmailAddress[];
+    phone?: string;
+    phones?: PhoneNumber[];
+    title?: string;
+    department?: string;
+    companyId?: string;
+    companyName?: string;
+    addresses?: Address[];
+    website?: string;
+    description?: string;
+    ownerId?: string;
+    customFields?: Record<string, unknown>;
+}
+type UpdateContactInput = Partial<CreateContactInput>;
+interface Company {
+    id: string;
+    name: string;
+    domain?: string;
+    website?: string;
+    industry?: string;
+    description?: string;
+    employeeCount?: number;
+    annualRevenue?: number;
+    phone?: string;
+    phones?: PhoneNumber[];
+    addresses?: Address[];
+    ownerId?: string;
+    customFields?: Record<string, unknown>;
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface CreateCompanyInput {
+    name: string;
+    domain?: string;
+    website?: string;
+    industry?: string;
+    description?: string;
+    employeeCount?: number;
+    annualRevenue?: number;
+    phone?: string;
+    phones?: PhoneNumber[];
+    addresses?: Address[];
+    ownerId?: string;
+    customFields?: Record<string, unknown>;
+}
+type UpdateCompanyInput = Partial<CreateCompanyInput>;
+interface Deal {
+    id: string;
+    name: string;
+    amount?: number;
+    currency?: string;
+    stage?: string;
+    status?: "open" | "won" | "lost";
+    probability?: number;
+    expectedCloseDate?: Date;
+    actualCloseDate?: Date;
+    companyId?: string;
+    contactIds?: string[];
+    ownerId?: string;
+    description?: string;
+    customFields?: Record<string, unknown>;
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface CreateDealInput {
+    name: string;
+    amount?: number;
+    currency?: string;
+    stage?: string;
+    status?: "open" | "won" | "lost";
+    probability?: number;
+    expectedCloseDate?: Date;
+    companyId?: string;
+    contactIds?: string[];
+    ownerId?: string;
+    description?: string;
+    customFields?: Record<string, unknown>;
+}
+type UpdateDealInput = Partial<CreateDealInput>;
+interface FilePermission {
+    type: "user" | "group" | "anyone";
+    role: "owner" | "writer" | "reader" | "commenter";
+    email?: string;
+    displayName?: string;
+}
+interface File {
+    id: string;
+    name: string;
+    mimeType?: string;
+    size?: number;
+    folderId?: string;
+    path?: string;
+    downloadUrl?: string;
+    webUrl?: string;
+    thumbnailUrl?: string;
+    isFolder: boolean;
+    parentId?: string;
+    ownerId?: string;
+    permissions?: FilePermission[];
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface IntegrationFolder {
+    id: string;
+    name: string;
+    path?: string;
+    parentId?: string;
+    webUrl?: string;
+    itemCount?: number;
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface CreateFolderInput {
+    name: string;
+    parentId?: string;
+}
+interface UploadFileInput {
+    name: string;
+    mimeType: string;
+    data: ArrayBuffer | Uint8Array;
+    folderId?: string;
+}
+interface Channel {
+    id: string;
+    name: string;
+    description?: string;
+    type: "public" | "private" | "direct" | "group";
+    memberCount?: number;
+    isArchived?: boolean;
+    topic?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface MessageAttachment {
+    id?: string;
+    type?: "file" | "image" | "video" | "link";
+    name?: string;
+    url?: string;
+    size?: number;
+    mimeType?: string;
+}
+interface MessageReaction {
+    emoji: string;
+    count: number;
+    userIds?: string[];
+}
+interface Message {
+    id: string;
+    channelId: string;
+    content: string;
+    senderId?: string;
+    senderName?: string;
+    threadId?: string;
+    replyCount?: number;
+    isEdited?: boolean;
+    attachments?: MessageAttachment[];
+    reactions?: MessageReaction[];
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface SendMessageInput {
+    channelId: string;
+    content: string;
+    threadId?: string;
+}
+interface CommunicationUser {
+    id: string;
+    name?: string;
+    username?: string;
+    displayName?: string;
+    email?: string;
+    avatarUrl?: string;
+    status?: "active" | "away" | "dnd" | "offline" | {
+        text: string;
+        emoji?: string;
+    };
+    isBot?: boolean;
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface Document {
+    id: string;
+    title: string;
+    content?: string;
+    type?: "page" | "document" | "note";
+    parentId?: string;
+    webUrl?: string;
+    iconUrl?: string;
+    iconEmoji?: string;
+    coverUrl?: string;
+    isArchived?: boolean;
+    properties?: Record<string, unknown>;
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface CreateDocumentInput {
+    title: string;
+    content?: string;
+    type?: "page" | "document" | "note";
+    parentId?: string;
+    iconEmoji?: string;
+}
+type UpdateDocumentInput = Partial<CreateDocumentInput>;
+type ColumnType = "text" | "number" | "boolean" | "date" | "datetime" | "select" | "multiSelect" | "url" | "email" | "phone" | "formula" | "relation" | "rollup" | "file" | "person" | "status" | "checkbox" | "unknown";
+interface SelectOption {
+    id: string;
+    name: string;
+    color?: string;
+}
+interface TableColumn {
+    id: string;
+    name: string;
+    type: ColumnType;
+    description?: string;
+    options?: string[] | SelectOption[];
+}
+interface Table {
+    id: string;
+    name: string;
+    description?: string;
+    columns: TableColumn[];
+    webUrl?: string;
+    isArchived?: boolean;
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface TableRow {
+    id: string;
+    tableId: string;
+    cells: Record<string, unknown>;
+    webUrl?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    remoteData?: unknown;
+}
+interface CreateTableRowInput {
+    cells: Record<string, unknown>;
+}
+type UpdateTableRowInput = CreateTableRowInput;
+interface PassthroughRequest {
+    connectionId: string;
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    body?: unknown;
+    query?: Record<string, string>;
+    headers?: Record<string, string>;
+}
+
+/**
+ * Stack0 Integrations Client
+ * Unified API for third-party integrations
+ */
+
+/**
+ * CRM operations client
+ */
+declare class CRM {
+    private http;
+    constructor(http: HttpClient);
+    listContacts(connectionId: string, options?: ListOptions): Promise<PaginatedResult<Contact>>;
+    getContact(connectionId: string, id: string): Promise<Contact>;
+    createContact(connectionId: string, data: CreateContactInput): Promise<Contact>;
+    updateContact(connectionId: string, id: string, data: UpdateContactInput): Promise<Contact>;
+    deleteContact(connectionId: string, id: string): Promise<{
+        success: boolean;
+    }>;
+    listCompanies(connectionId: string, options?: ListOptions): Promise<PaginatedResult<Company>>;
+    getCompany(connectionId: string, id: string): Promise<Company>;
+    createCompany(connectionId: string, data: CreateCompanyInput): Promise<Company>;
+    updateCompany(connectionId: string, id: string, data: UpdateCompanyInput): Promise<Company>;
+    deleteCompany(connectionId: string, id: string): Promise<{
+        success: boolean;
+    }>;
+    listDeals(connectionId: string, options?: ListOptions): Promise<PaginatedResult<Deal>>;
+    getDeal(connectionId: string, id: string): Promise<Deal>;
+    createDeal(connectionId: string, data: CreateDealInput): Promise<Deal>;
+    updateDeal(connectionId: string, id: string, data: UpdateDealInput): Promise<Deal>;
+    deleteDeal(connectionId: string, id: string): Promise<{
+        success: boolean;
+    }>;
+}
+/**
+ * Storage operations client
+ */
+declare class Storage {
+    private http;
+    constructor(http: HttpClient);
+    listFiles(connectionId: string, folderId?: string, options?: ListOptions): Promise<PaginatedResult<File>>;
+    getFile(connectionId: string, id: string): Promise<File>;
+    uploadFile(connectionId: string, input: UploadFileInput): Promise<File>;
+    deleteFile(connectionId: string, id: string): Promise<{
+        success: boolean;
+    }>;
+    downloadFile(connectionId: string, id: string): Promise<{
+        data: ArrayBuffer;
+        mimeType: string;
+        filename: string;
+    }>;
+    listFolders(connectionId: string, parentId?: string, options?: ListOptions): Promise<PaginatedResult<IntegrationFolder>>;
+    getFolder(connectionId: string, id: string): Promise<IntegrationFolder>;
+    createFolder(connectionId: string, data: CreateFolderInput): Promise<IntegrationFolder>;
+    deleteFolder(connectionId: string, id: string): Promise<{
+        success: boolean;
+    }>;
+}
+/**
+ * Communication operations client
+ */
+declare class Communication {
+    private http;
+    constructor(http: HttpClient);
+    listChannels(connectionId: string, options?: ListOptions): Promise<PaginatedResult<Channel>>;
+    getChannel(connectionId: string, id: string): Promise<Channel>;
+    listMessages(connectionId: string, channelId: string, options?: ListOptions): Promise<PaginatedResult<Message>>;
+    sendMessage(connectionId: string, input: SendMessageInput): Promise<Message>;
+    listUsers(connectionId: string, options?: ListOptions): Promise<PaginatedResult<CommunicationUser>>;
+}
+/**
+ * Productivity operations client
+ */
+declare class Productivity {
+    private http;
+    constructor(http: HttpClient);
+    listDocuments(connectionId: string, parentId?: string, options?: ListOptions): Promise<PaginatedResult<Document>>;
+    getDocument(connectionId: string, id: string): Promise<Document>;
+    createDocument(connectionId: string, data: CreateDocumentInput): Promise<Document>;
+    updateDocument(connectionId: string, id: string, data: UpdateDocumentInput): Promise<Document>;
+    listTables(connectionId: string, options?: ListOptions): Promise<PaginatedResult<Table>>;
+    getTable(connectionId: string, id: string): Promise<Table>;
+    listTableRows(connectionId: string, tableId: string, options?: ListOptions): Promise<PaginatedResult<TableRow>>;
+    getTableRow(connectionId: string, tableId: string, rowId: string): Promise<TableRow>;
+    createTableRow(connectionId: string, tableId: string, data: CreateTableRowInput): Promise<TableRow>;
+    updateTableRow(connectionId: string, tableId: string, rowId: string, data: UpdateTableRowInput): Promise<TableRow>;
+    deleteTableRow(connectionId: string, tableId: string, rowId: string): Promise<{
+        success: boolean;
+    }>;
+}
+/**
+ * Stack0 Integrations SDK Client
+ *
+ * @example
+ * ```typescript
+ * import { Integrations } from '@stack0/sdk';
+ *
+ * const integrations = new Integrations({ apiKey: 'stack0_...' });
+ *
+ * // List connectors
+ * const connectors = await integrations.listConnectors();
+ *
+ * // List contacts from a CRM connection
+ * const contacts = await integrations.crm.listContacts('conn_123');
+ *
+ * // Create a contact
+ * const contact = await integrations.crm.createContact('conn_123', {
+ *   firstName: 'John',
+ *   lastName: 'Doe',
+ *   email: 'john@example.com',
+ * });
+ *
+ * // Send a message via Slack
+ * await integrations.communication.sendMessage('conn_456', {
+ *   channelId: 'C123',
+ *   content: 'Hello from Stack0!',
+ * });
+ *
+ * // Upload a file to Google Drive
+ * await integrations.storage.uploadFile('conn_789', {
+ *   name: 'report.pdf',
+ *   mimeType: 'application/pdf',
+ *   data: fileBuffer,
+ * });
+ * ```
+ */
+declare class Integrations {
+    private http;
+    crm: CRM;
+    storage: Storage;
+    communication: Communication;
+    productivity: Productivity;
+    constructor(config: HttpClientConfig);
+    /**
+     * List all available connectors
+     */
+    listConnectors(category?: ConnectorCategory): Promise<Connector[]>;
+    /**
+     * Get a specific connector
+     */
+    getConnector(slug: string): Promise<Connector>;
+    /**
+     * List all connections
+     */
+    listConnections(options?: {
+        connectorId?: string;
+        status?: Connection["status"];
+    }): Promise<Connection[]>;
+    /**
+     * Get a specific connection
+     */
+    getConnection(id: string): Promise<Connection>;
+    /**
+     * Create a new connection (initiates OAuth flow)
+     * Returns the OAuth authorization URL to redirect the user to
+     */
+    createConnection(connectorSlug: string, options?: {
+        name?: string;
+        projectId?: string;
+    }): Promise<{
+        connectionId: string;
+        authorizationUrl: string;
+    }>;
+    /**
+     * Delete a connection
+     */
+    deleteConnection(id: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Test a connection's credentials
+     */
+    testConnection(id: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Make a raw passthrough request to the provider API
+     */
+    passthrough(request: PassthroughRequest): Promise<unknown>;
+}
+
 /**
  * Stack0 SDK
  * Official SDK for Stack0 services
@@ -48,6 +569,15 @@ export { B as BatchJobStatus, C as CreateBatchResponse, c as CreateScheduleRespo
  *   url: 'https://example.com/article',
  *   mode: 'markdown',
  * });
+ *
+ * // List contacts from a connected CRM
+ * const contacts = await stack0.integrations.crm.listContacts('conn_123');
+ *
+ * // Send a Slack message
+ * await stack0.integrations.communication.sendMessage('conn_456', {
+ *   channelId: 'C123',
+ *   content: 'Hello from Stack0!',
+ * });
  * ```
  */
 
@@ -64,6 +594,7 @@ declare class Stack0 {
     cdn: CDN;
     screenshots: Screenshots;
     extraction: Extraction;
+    integrations: Integrations;
     /**
      * @deprecated Use `screenshots` and `extraction` instead. Will be removed in a future version.
      */
@@ -71,4 +602,4 @@ declare class Stack0 {
     constructor(config: Stack0Config);
 }
 
-export { CDN, Extraction, Mail, Screenshots, Stack0, type Stack0Config, Webdata, Stack0 as default };
+export { CDN, type Channel, type CommunicationUser, type Company, type Connection, type Connector, type ConnectorCategory, type Contact, type CreateCompanyInput, type CreateContactInput, type CreateDealInput, type Deal, Extraction, type Address as IntegrationAddress, type ColumnType as IntegrationColumnType, type CreateDocumentInput as IntegrationCreateDocumentInput, type CreateFolderInput as IntegrationCreateFolderInput, type CreateTableRowInput as IntegrationCreateTableRowInput, type Document as IntegrationDocument, type IntegrationEmailAddress, type File as IntegrationFile, type FilePermission as IntegrationFilePermission, type IntegrationFolder, type MessageAttachment as IntegrationMessageAttachment, type MessageReaction as IntegrationMessageReaction, type PhoneNumber as IntegrationPhoneNumber, type SelectOption as IntegrationSelectOption, type Table as IntegrationTable, type TableColumn as IntegrationTableColumn, type TableRow as IntegrationTableRow, type UpdateDocumentInput as IntegrationUpdateDocumentInput, type UpdateTableRowInput as IntegrationUpdateTableRowInput, Integrations, type ListOptions as IntegrationsListOptions, type PaginatedResult as IntegrationsPaginatedResult, Mail, type Message, type PassthroughRequest, Screenshots, type SendMessageInput, Stack0, type Stack0Config, type UpdateCompanyInput, type UpdateContactInput, type UpdateDealInput, type UploadFileInput, Webdata, Stack0 as default };