@soulbatical/tetra-core 0.10.4 → 0.11.0

package/dist/shared/email/gmail.d.ts

@@ -1,208 +0,0 @@
-/**
- * Gmail API Client — Generic OAuth2-based Gmail integration for Tetra projects.
- *
- * Supports: sending (plain text + HTML), reading, searching, attachments.
- * Token lifecycle:
- * 1. startGmailOAuth(): loopback OAuth2 flow → encrypted tokens in gmail_accounts table
- * 2. getAccessToken(): auto-refreshes expired tokens using refresh_token
- * 3. disconnectGmail(): deactivates account in DB
- *
- * @module @soulbatical/tetra-core/email/gmail
- */
-import type { SupabaseClient } from '@supabase/supabase-js';
-import { Router } from 'express';
-export interface GmailTokens {
-    access_token: string;
-    refresh_token: string;
-    expires_at: Date;
-}
-export interface GmailSendOptions {
-    cc?: string;
-    bcc?: string;
-    reply_to?: string;
-}
-export interface GmailSendResult {
-    id: string;
-    threadId: string;
-    labelIds: string[];
-}
-export interface GmailSearchResult {
-    messages: GmailMessageSummary[];
-    resultSizeEstimate: number;
-}
-export interface GmailMessageSummary {
-    id: string;
-    threadId: string;
-}
-export interface GmailMessageHeader {
-    name: string;
-    value: string;
-}
-export interface GmailMessagePart {
-    partId: string;
-    mimeType: string;
-    filename: string;
-    headers: GmailMessageHeader[];
-    body: {
-        attachmentId?: string;
-        size: number;
-        data?: string;
-    };
-    parts?: GmailMessagePart[];
-}
-export interface GmailMessage {
-    id: string;
-    threadId: string;
-    labelIds: string[];
-    snippet: string;
-    internalDate: string;
-    payload: GmailMessagePart;
-    sizeEstimate: number;
-}
-export interface GmailAttachmentInfo {
-    attachmentId: string;
-    filename: string;
-    mimeType: string;
-    size: number;
-}
-export interface GmailProfile {
-    emailAddress: string;
-    messagesTotal: number;
-    threadsTotal: number;
-    historyId: string;
-}
-export interface GmailOAuthConfig {
-    clientId: string;
-    clientSecret: string;
-    /** Loopback port for OAuth callback. Default: 9876 */
-    loopbackPort?: number;
-    /** Additional scopes beyond send + readonly */
-    additionalScopes?: string[];
-    /** Web-based redirect URI (overrides loopback). Use for deployed backends. */
-    redirectUri?: string;
-}
-export interface GmailOAuthRoutesConfig {
-    /** Frontend URL to redirect to after OAuth completes */
-    frontendUrl?: string;
-    /** Path on frontend to redirect to after success. Default: /settings */
-    frontendSuccessPath?: string;
-    /** Path on frontend to redirect to after error. Default: /settings */
-    frontendErrorPath?: string;
-}
-export interface GmailAuthServerStatus {
-    running: boolean;
-    result: {
-        email: string;
-    } | null;
-    error: string | null;
-}
-/**
- * Get or create a GmailClient for a user.
- * Loads encrypted tokens from gmail_accounts table.
- */
-export declare function getGmailClient(supabase: SupabaseClient, userId: string, email?: string): Promise<GmailClient | null>;
-/**
- * List all active Gmail accounts for a user.
- */
-export declare function listGmailAccounts(supabase: SupabaseClient, userId: string): Promise<Array<{
-    id: string;
-    email: string;
-    created_at: string;
-}>>;
-/**
- * Clear cached client for a user.
- */
-export declare function clearGmailClientCache(userId: string, email?: string): void;
-/**
- * Disconnect a Gmail account (sets is_active = false).
- */
-export declare function disconnectGmail(supabase: SupabaseClient, userId: string, email?: string): Promise<string[]>;
-/**
- * Generate the OAuth2 authorization URL.
- */
-export declare function getGmailAuthUrl(config: GmailOAuthConfig, state?: string): string;
-/**
- * Start a loopback OAuth server that handles the callback.
- * Auto-closes after handling or after 5 minutes.
- */
-export declare function startGmailOAuth(supabase: SupabaseClient, config: GmailOAuthConfig, organizationId: string, userId: string): void;
-/**
- * Get the current state of the OAuth auth server.
- */
-export declare function getGmailAuthServerStatus(): GmailAuthServerStatus;
-/**
- * Reset auth server state so a new connect flow can start.
- */
-export declare function resetGmailAuthServerState(): void;
-/**
- * Exchange authorization code for tokens and store encrypted in DB.
- */
-export declare function exchangeGmailCode(supabase: SupabaseClient, config: GmailOAuthConfig, code: string, organizationId: string, userId: string): Promise<{
-    email: string;
-}>;
-export declare class GmailClient {
-    private supabase;
-    private accountId;
-    private email;
-    private tokens;
-    constructor(supabase: SupabaseClient, _userId: string, accountId: string, email: string, tokens: GmailTokens);
-    getEmail(): string;
-    /**
-     * Get a valid access token, refreshing if necessary.
-     */
-    private getAccessToken;
-    /**
-     * Refresh the access token using the refresh token.
-     */
-    private refreshToken;
-    /**
-     * Make an authenticated request to the Gmail API.
-     */
-    private request;
-    /**
-     * Send a plain text email.
-     */
-    send(to: string, subject: string, body: string, options?: GmailSendOptions): Promise<GmailSendResult>;
-    /**
-     * Send an HTML email (for transactional/notification emails).
-     */
-    sendHtml(to: string, subject: string, html: string, options?: GmailSendOptions): Promise<GmailSendResult>;
-    /**
-     * Search for messages using Gmail query syntax.
-     */
-    search(query: string, maxResults?: number): Promise<GmailSearchResult>;
-    /**
-     * Read a full message by ID.
-     */
-    read(messageId: string): Promise<GmailMessage>;
-    /**
-     * List attachments from a message.
-     */
-    extractAttachments(message: GmailMessage): GmailAttachmentInfo[];
-    /**
-     * Download an attachment as a Buffer.
-     */
-    downloadAttachment(messageId: string, attachmentId: string): Promise<Buffer>;
-    /**
-     * Get Gmail profile information.
-     */
-    getProfile(): Promise<GmailProfile>;
-    /**
-     * Extract plain text body from a message.
-     */
-    extractTextBody(message: GmailMessage): string;
-    private buildMimeHeaders;
-    private sendRaw;
-}
-/**
- * Add Gmail OAuth routes to an Express router.
- * Requires authenticateToken middleware to be applied before mounting.
- *
- * Routes:
- * - POST /connect — Start OAuth flow (returns auth_url to redirect user to)
- * - GET  /callback — Google redirects here after authorization
- * - GET  /status   — Check connection status
- * - POST /disconnect — Disconnect Gmail account
- */
-export declare function addGmailOAuthRoutes(router: Router, getSystemDB: () => SupabaseClient, routesConfig?: GmailOAuthRoutesConfig): void;
-//# sourceMappingURL=gmail.d.ts.map

package/dist/shared/email/gmail.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gmail.d.ts","sourceRoot":"","sources":["../../../src/shared/email/gmail.ts"],"names":[],"mappings":"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"}