@marcfargas/go-easy 0.0.1 → 0.2.0

package/dist/gmail/index.js

@@ -0,0 +1,395 @@
+/**
+ * Gmail module — search, read, send, reply, forward, labels, drafts.
+ *
+ * All functions take an OAuth2Client as first argument.
+ * Use `getAuth('gmail', 'account@email.com')` from the auth module.
+ */
+import { gmail } from '@googleapis/gmail';
+import { guardOperation } from '../safety.js';
+import { NotFoundError, QuotaError, GoEasyError } from '../errors.js';
+import { parseMessage, buildMimeMessage, buildForwardMime, base64UrlEncode } from './helpers.js';
+/** Get a Gmail API client instance */
+function gmailApi(auth) {
+    return gmail({ version: 'v1', auth });
+}
+/** Wrap Google API errors into our error types */
+function handleApiError(err, context) {
+    if (err instanceof GoEasyError)
+        throw err;
+    const gErr = err;
+    if (gErr.code === 404)
+        throw new NotFoundError('message', context, err);
+    if (gErr.code === 429)
+        throw new QuotaError('gmail', err);
+    throw new GoEasyError(`Gmail ${context}: ${gErr.message ?? 'Unknown error'}`, 'GMAIL_ERROR', err);
+}
+/**
+ * Get the authenticated user's email address.
+ */
+export async function getProfile(auth) {
+    const gmail = gmailApi(auth);
+    const res = await gmail.users.getProfile({ userId: 'me' });
+    return res.data.emailAddress ?? '';
+}
+/**
+ * Search messages using Gmail query syntax.
+ *
+ * @example
+ * ```ts
+ * const results = await search(auth, { query: 'from:client is:unread' });
+ * ```
+ */
+export async function search(auth, opts) {
+    const gmail = gmailApi(auth);
+    try {
+        const listRes = await gmail.users.messages.list({
+            userId: 'me',
+            q: opts.query,
+            maxResults: opts.maxResults ?? 20,
+            pageToken: opts.pageToken,
+            includeSpamTrash: opts.includeSpamTrash ?? false,
+        });
+        const messageRefs = listRes.data.messages ?? [];
+        // Fetch full message data for each result
+        const messages = await Promise.all(messageRefs.map(async (ref) => {
+            const msg = await gmail.users.messages.get({
+                userId: 'me',
+                id: ref.id,
+                format: 'full',
+            });
+            return parseMessage(msg.data);
+        }));
+        return {
+            items: messages,
+            nextPageToken: listRes.data.nextPageToken ?? undefined,
+            resultSizeEstimate: listRes.data.resultSizeEstimate ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, `search "${opts.query}"`);
+    }
+}
+/**
+ * Get a single message by ID.
+ */
+export async function getMessage(auth, messageId) {
+    const gmail = gmailApi(auth);
+    try {
+        const res = await gmail.users.messages.get({
+            userId: 'me',
+            id: messageId,
+            format: 'full',
+        });
+        return parseMessage(res.data);
+    }
+    catch (err) {
+        handleApiError(err, messageId);
+    }
+}
+/**
+ * Get a thread (conversation) by ID.
+ */
+export async function getThread(auth, threadId) {
+    const gmail = gmailApi(auth);
+    try {
+        const res = await gmail.users.threads.get({
+            userId: 'me',
+            id: threadId,
+            format: 'full',
+        });
+        const messages = (res.data.messages ?? []).map(parseMessage);
+        return {
+            id: res.data.id ?? threadId,
+            snippet: res.data.snippet ?? '',
+            messages,
+        };
+    }
+    catch (err) {
+        handleApiError(err, threadId);
+    }
+}
+/**
+ * Send an email.
+ *
+ * ⚠️ DESTRUCTIVE — requires safety confirmation.
+ */
+export async function send(auth, opts) {
+    const to = Array.isArray(opts.to) ? opts.to.join(', ') : opts.to;
+    await guardOperation({
+        name: 'gmail.send',
+        level: 'DESTRUCTIVE',
+        description: `Send email to ${to}: "${opts.subject}"`,
+        details: { to: opts.to, subject: opts.subject },
+    });
+    const gmail = gmailApi(auth);
+    const from = await getProfile(auth);
+    const mime = await buildMimeMessage(from, opts);
+    const raw = base64UrlEncode(mime);
+    try {
+        const res = await gmail.users.messages.send({
+            userId: 'me',
+            requestBody: { raw },
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            threadId: res.data.threadId ?? undefined,
+            labelIds: res.data.labelIds ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, 'send');
+    }
+}
+/**
+ * Reply to a thread.
+ *
+ * ⚠️ DESTRUCTIVE — requires safety confirmation.
+ */
+export async function reply(auth, opts) {
+    await guardOperation({
+        name: 'gmail.reply',
+        level: 'DESTRUCTIVE',
+        description: `Reply to thread ${opts.threadId}`,
+        details: { threadId: opts.threadId, messageId: opts.messageId },
+    });
+    const gmail = gmailApi(auth);
+    const from = await getProfile(auth);
+    // Get the original message for threading headers and recipients
+    const original = await getMessage(auth, opts.messageId);
+    const replyTo = opts.replyAll
+        ? [...new Set([original.from, ...original.to, ...original.cc])].filter((addr) => !addr.includes(from))
+        : [original.from];
+    const sendOpts = {
+        to: replyTo,
+        subject: original.subject.startsWith('Re:')
+            ? original.subject
+            : `Re: ${original.subject}`,
+        body: opts.body,
+        html: opts.html,
+        attachments: opts.attachments,
+    };
+    const extraHeaders = {
+        'In-Reply-To': `<${opts.messageId}>`,
+        References: `<${opts.messageId}>`,
+    };
+    const mime = await buildMimeMessage(from, sendOpts, extraHeaders);
+    const raw = base64UrlEncode(mime);
+    try {
+        const res = await gmail.users.messages.send({
+            userId: 'me',
+            requestBody: {
+                raw,
+                threadId: opts.threadId,
+            },
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            threadId: res.data.threadId ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, 'reply');
+    }
+}
+/**
+ * Forward a message to new recipients.
+ *
+ * Fetches the original message, quotes its body, re-attaches original
+ * attachments (unless `includeAttachments: false`), and sends.
+ *
+ * ⚠️ DESTRUCTIVE — requires safety confirmation.
+ */
+export async function forward(auth, opts) {
+    const to = Array.isArray(opts.to) ? opts.to.join(', ') : opts.to;
+    await guardOperation({
+        name: 'gmail.forward',
+        level: 'DESTRUCTIVE',
+        description: `Forward message ${opts.messageId} to ${to}`,
+        details: { messageId: opts.messageId, to: opts.to },
+    });
+    const gmail = gmailApi(auth);
+    const from = await getProfile(auth);
+    // Fetch original message
+    const original = await getMessage(auth, opts.messageId);
+    // Fetch original attachments as Buffers
+    const bufferAttachments = [];
+    if (opts.includeAttachments !== false && original.attachments.length > 0) {
+        for (const att of original.attachments) {
+            const data = await getAttachmentContent(auth, opts.messageId, att.id);
+            bufferAttachments.push({
+                filename: att.filename,
+                mimeType: att.mimeType,
+                data,
+            });
+        }
+    }
+    const subject = original.subject.startsWith('Fwd:')
+        ? original.subject
+        : `Fwd: ${original.subject}`;
+    const mime = await buildForwardMime(from, to, subject, opts.body, original.body, bufferAttachments);
+    const raw = base64UrlEncode(mime);
+    try {
+        const res = await gmail.users.messages.send({
+            userId: 'me',
+            requestBody: { raw },
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            threadId: res.data.threadId ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, 'forward');
+    }
+}
+/**
+ * Batch modify labels on multiple messages.
+ *
+ * This is a WRITE operation (reversible), no safety gate.
+ */
+export async function batchModifyLabels(auth, opts) {
+    const gmail = gmailApi(auth);
+    try {
+        await gmail.users.messages.batchModify({
+            userId: 'me',
+            requestBody: {
+                ids: opts.messageIds,
+                addLabelIds: opts.addLabelIds,
+                removeLabelIds: opts.removeLabelIds,
+            },
+        });
+        return {
+            ok: true,
+            id: `batch:${opts.messageIds.length}`,
+            labelIds: opts.addLabelIds,
+        };
+    }
+    catch (err) {
+        handleApiError(err, 'batchModifyLabels');
+    }
+}
+/**
+ * List all labels for the account.
+ */
+export async function listLabels(auth) {
+    const gmail = gmailApi(auth);
+    try {
+        const res = await gmail.users.labels.list({ userId: 'me' });
+        return (res.data.labels ?? []).map((l) => ({
+            id: l.id ?? '',
+            name: l.name ?? '',
+            type: l.type ?? '',
+        }));
+    }
+    catch (err) {
+        handleApiError(err, 'listLabels');
+    }
+}
+/**
+ * Create a draft.
+ *
+ * WRITE operation (reversible), no safety gate.
+ */
+export async function createDraft(auth, opts) {
+    const gmail = gmailApi(auth);
+    const from = await getProfile(auth);
+    const mime = await buildMimeMessage(from, opts);
+    const raw = base64UrlEncode(mime);
+    try {
+        const res = await gmail.users.drafts.create({
+            userId: 'me',
+            requestBody: {
+                message: { raw },
+            },
+        });
+        return {
+            id: res.data.id ?? '',
+            message: parseMessage(res.data.message ?? {}),
+        };
+    }
+    catch (err) {
+        handleApiError(err, 'createDraft');
+    }
+}
+/**
+ * Send an existing draft.
+ *
+ * ⚠️ DESTRUCTIVE — requires safety confirmation.
+ */
+export async function sendDraft(auth, draftId) {
+    await guardOperation({
+        name: 'gmail.sendDraft',
+        level: 'DESTRUCTIVE',
+        description: `Send draft ${draftId}`,
+        details: { draftId },
+    });
+    const gmail = gmailApi(auth);
+    try {
+        const res = await gmail.users.drafts.send({
+            userId: 'me',
+            requestBody: { id: draftId },
+        });
+        return {
+            ok: true,
+            id: res.data.id ?? '',
+            threadId: res.data.threadId ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, 'sendDraft');
+    }
+}
+/**
+ * List drafts.
+ */
+export async function listDrafts(auth, maxResults = 20) {
+    const gmail = gmailApi(auth);
+    try {
+        const res = await gmail.users.drafts.list({
+            userId: 'me',
+            maxResults,
+        });
+        const drafts = await Promise.all((res.data.drafts ?? []).map(async (d) => {
+            const full = await gmail.users.drafts.get({
+                userId: 'me',
+                id: d.id,
+                format: 'full',
+            });
+            return {
+                id: full.data.id ?? '',
+                message: parseMessage(full.data.message ?? {}),
+            };
+        }));
+        return {
+            items: drafts,
+            nextPageToken: res.data.nextPageToken ?? undefined,
+        };
+    }
+    catch (err) {
+        handleApiError(err, 'listDrafts');
+    }
+}
+/**
+ * Download an attachment's content as a Buffer.
+ */
+export async function getAttachmentContent(auth, messageId, attachmentId) {
+    const gmail = gmailApi(auth);
+    try {
+        const res = await gmail.users.messages.attachments.get({
+            userId: 'me',
+            messageId,
+            id: attachmentId,
+        });
+        const data = res.data.data;
+        if (!data)
+            throw new GoEasyError('Empty attachment data', 'GMAIL_ERROR');
+        return Buffer.from(data, 'base64url');
+    }
+    catch (err) {
+        handleApiError(err, `attachment ${attachmentId}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/gmail/index.js.map

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

package/dist/gmail/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Gmail types — agent-friendly shapes, not raw API types.
+ */
+/** A simplified email message */
+export interface GmailMessage {
+    id: string;
+    threadId: string;
+    /** RFC 2822 date string */
+    date: string;
+    from: string;
+    to: string[];
+    cc: string[];
+    bcc: string[];
+    subject: string;
+    /** Snippet (truncated plain text preview) */
+    snippet: string;
+    /** Message body */
+    body: {
+        text?: string;
+        html?: string;
+    };
+    /** Label IDs applied to this message */
+    labelIds: string[];
+    /** Attachment metadata (not downloaded by default) */
+    attachments: AttachmentInfo[];
+}
+/** A thread (conversation) */
+export interface GmailThread {
+    id: string;
+    /** Snippet of the last message */
+    snippet: string;
+    /** All messages in the thread, oldest first */
+    messages: GmailMessage[];
+}
+/** Attachment metadata */
+export interface AttachmentInfo {
+    /** Attachment ID (needed for download) */
+    id: string;
+    /** Original filename */
+    filename: string;
+    /** MIME type */
+    mimeType: string;
+    /** Size in bytes */
+    size: number;
+}
+/** Options for sending an email */
+export interface SendOptions {
+    to: string | string[];
+    cc?: string | string[];
+    bcc?: string | string[];
+    subject: string;
+    /** Plain text body */
+    body?: string;
+    /** HTML body (if provided, creates multipart/alternative) */
+    html?: string;
+    /** File paths to attach */
+    attachments?: string[];
+}
+/** Options for replying to a thread */
+export interface ReplyOptions {
+    /** Thread ID to reply to */
+    threadId: string;
+    /** Message ID to reply to (for In-Reply-To header) */
+    messageId: string;
+    /** Plain text body */
+    body?: string;
+    /** HTML body */
+    html?: string;
+    /** File paths to attach */
+    attachments?: string[];
+    /** Reply to all recipients (default: false, reply to sender only) */
+    replyAll?: boolean;
+}
+/** Options for forwarding a message */
+export interface ForwardOptions {
+    /** Message ID to forward */
+    messageId: string;
+    /** Recipients */
+    to: string | string[];
+    /** Optional body prepended to the forwarded message */
+    body?: string;
+    /** Include original attachments (default: true) */
+    includeAttachments?: boolean;
+}
+/** Options for listing/searching */
+export interface SearchOptions {
+    /** Gmail search query (same syntax as Gmail UI) */
+    query: string;
+    /** Maximum results (default: 20) */
+    maxResults?: number;
+    /** Page token for pagination */
+    pageToken?: string;
+    /** Include spam and trash (default: false) */
+    includeSpamTrash?: boolean;
+}
+/** Paginated list result */
+export interface ListResult<T> {
+    items: T[];
+    /** Token for next page, undefined if no more results */
+    nextPageToken?: string;
+    /** Estimated total results (Gmail-specific, may be inaccurate) */
+    resultSizeEstimate?: number;
+}
+/** Options for batch label modification */
+export interface BatchLabelOptions {
+    /** Message IDs to modify */
+    messageIds: string[];
+    /** Label IDs to add */
+    addLabelIds?: string[];
+    /** Label IDs to remove */
+    removeLabelIds?: string[];
+}
+/** Draft info */
+export interface GmailDraft {
+    id: string;
+    message: GmailMessage;
+}
+/** An in-memory attachment (for forwarding, where data comes from API not filesystem) */
+export interface BufferAttachment {
+    /** Original filename */
+    filename: string;
+    /** MIME type */
+    mimeType: string;
+    /** Attachment content */
+    data: Buffer;
+}
+/** Result of a write operation */
+export interface WriteResult {
+    /** Whether the operation succeeded */
+    ok: true;
+    /** ID of the created/modified resource */
+    id: string;
+    /** Thread ID (for messages) */
+    threadId?: string;
+    /** Label IDs (for label operations) */
+    labelIds?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/gmail/types.d.ts.map

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

package/dist/gmail/types.js

@@ -0,0 +1,5 @@
+/**
+ * Gmail types — agent-friendly shapes, not raw API types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/gmail/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/gmail/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * go-easy — Google APIs made easy.
+ *
+ * @example
+ * ```ts
+ * import { getAuth } from '@marcfargas/go-easy/auth';
+ * import { search, send } from '@marcfargas/go-easy/gmail';
+ *
+ * const auth = await getAuth('gmail', 'marc@blegal.eu');
+ * const results = await search(auth, { query: 'is:unread' });
+ * ```
+ */
+export { getAuth, listAccounts, clearAuthCache } from './auth.js';
+export type { GoogleService } from './auth.js';
+export { setSafetyContext, resetSafetyContext, guardOperation } from './safety.js';
+export type { SafetyContext, SafetyLevel, OperationInfo } from './safety.js';
+export { GoEasyError, AuthError, NotFoundError, QuotaError, SafetyError, } from './errors.js';
+import * as gmail from './gmail/index.js';
+import * as drive from './drive/index.js';
+import * as calendar from './calendar/index.js';
+export { gmail, drive, calendar };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG7E,OAAO,EACL,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * go-easy — Google APIs made easy.
+ *
+ * @example
+ * ```ts
+ * import { getAuth } from '@marcfargas/go-easy/auth';
+ * import { search, send } from '@marcfargas/go-easy/gmail';
+ *
+ * const auth = await getAuth('gmail', 'marc@blegal.eu');
+ * const results = await search(auth, { query: 'is:unread' });
+ * ```
+ */
+// Auth
+export { getAuth, listAccounts, clearAuthCache } from './auth.js';
+// Safety
+export { setSafetyContext, resetSafetyContext, guardOperation } from './safety.js';
+// Errors
+export { GoEasyError, AuthError, NotFoundError, QuotaError, SafetyError, } from './errors.js';
+// Service modules (re-exported as namespaces)
+import * as gmail from './gmail/index.js';
+import * as drive from './drive/index.js';
+import * as calendar from './calendar/index.js';
+export { gmail, drive, calendar };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO;AACP,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGlE,SAAS;AACT,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGnF,SAAS;AACT,OAAO,EACL,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,8CAA8C;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC"}

package/dist/safety.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Safety module — guards destructive/irreversible operations.
+ *
+ * Operations are classified:
+ *   READ        — no gate (search, get, list)
+ *   WRITE       — logged, no block (create draft, label, upload)
+ *   DESTRUCTIVE — blocked unless SafetyContext.confirm() returns true
+ *                 (send email, share file externally, delete event with attendees)
+ *
+ * Usage:
+ *   // Set up context at startup (gateway or agent)
+ *   setSafetyContext({
+ *     confirm: async (op) => {
+ *       console.log(`⚠️  ${op.description}`);
+ *       return promptUser('Proceed? (y/n)') === 'y';
+ *     }
+ *   });
+ *
+ *   // Inside library functions
+ *   await guardOperation({
+ *     name: 'gmail.send',
+ *     level: 'DESTRUCTIVE',
+ *     description: 'Send email to client@example.com',
+ *     details: { to: 'client@example.com', subject: 'Invoice' }
+ *   });
+ */
+export type SafetyLevel = 'READ' | 'WRITE' | 'DESTRUCTIVE';
+export interface OperationInfo {
+    /** Function name, e.g. 'gmail.send' */
+    name: string;
+    /** Safety classification */
+    level: SafetyLevel;
+    /** Human-readable description of what will happen */
+    description: string;
+    /** Structured details for logging */
+    details?: Record<string, unknown>;
+}
+export interface SafetyContext {
+    /**
+     * Called for DESTRUCTIVE operations.
+     * Return true to proceed, false to block.
+     */
+    confirm: (op: OperationInfo) => Promise<boolean>;
+}
+/** Set the safety context. Call once at startup. */
+export declare function setSafetyContext(ctx: SafetyContext): void;
+/** Reset to default (block-all) context. Useful for tests. */
+export declare function resetSafetyContext(): void;
+/** Get the current safety context. */
+export declare function getSafetyContext(): SafetyContext;
+/**
+ * Guard an operation. READ and WRITE pass through.
+ * DESTRUCTIVE operations require confirmation from the safety context.
+ *
+ * @throws SafetyError if destructive and not confirmed
+ */
+export declare function guardOperation(op: OperationInfo): Promise<void>;
+//# sourceMappingURL=safety.d.ts.map