@marktoflow/integrations 2.0.4-alpha.1 → 2.0.4

package/dist/services/outlook-trigger.d.ts

@@ -1,121 +0,0 @@
-import { TriggerType } from '@marktoflow/core';
-export interface OutlookTriggerConfig {
-    token: string;
-    notificationUrl: string;
-    changeTypes?: ('created' | 'updated' | 'deleted')[];
-    resource?: string;
-    expirationMinutes?: number;
-    clientState?: string;
-    triggers: Array<{
-        id: string;
-        event: 'email_received' | 'email_updated' | 'email_deleted';
-        handler: (payload: OutlookTriggerPayload) => Promise<void>;
-    }>;
-}
-export interface OutlookTriggerPayload {
-    type: TriggerType;
-    event: 'email_received' | 'email_updated' | 'email_deleted';
-    subscriptionId: string;
-    changeType: string;
-    resource: string;
-    resourceData?: {
-        id: string;
-        [key: string]: unknown;
-    };
-    clientState?: string;
-    tenantId?: string;
-}
-export interface GraphSubscription {
-    id: string;
-    resource: string;
-    changeType: string;
-    notificationUrl: string;
-    expirationDateTime: string;
-    clientState?: string;
-}
-export interface GraphNotification {
-    value: Array<{
-        subscriptionId: string;
-        subscriptionExpirationDateTime: string;
-        changeType: string;
-        resource: string;
-        resourceData?: {
-            '@odata.type': string;
-            '@odata.id': string;
-            '@odata.etag': string;
-            id: string;
-            [key: string]: unknown;
-        };
-        clientState?: string;
-        tenantId?: string;
-    }>;
-}
-export interface GraphValidationRequest extends Record<string, unknown> {
-    validationToken: string;
-}
-/**
- * Outlook trigger handler for Microsoft Graph webhook subscriptions.
- *
- * Setup requirements:
- * 1. Register an Azure AD application with Mail.Read permissions
- * 2. Set up a publicly accessible webhook endpoint
- * 3. Call subscribe() to start receiving notifications
- * 4. Handle subscription renewal before expiration (max ~3 days)
- */
-export declare class OutlookTrigger {
-    private config;
-    private client;
-    private subscription?;
-    constructor(config: OutlookTriggerConfig);
-    /**
-     * Create a subscription to receive mail notifications.
-     */
-    subscribe(): Promise<GraphSubscription>;
-    /**
-     * Renew an existing subscription.
-     */
-    renew(expirationMinutes?: number): Promise<GraphSubscription>;
-    /**
-     * Delete the subscription (stop receiving notifications).
-     */
-    unsubscribe(): Promise<void>;
-    /**
-     * Get the current subscription status.
-     */
-    getSubscription(): GraphSubscription | undefined;
-    /**
-     * Check if subscription is still active (not expired).
-     */
-    isSubscriptionActive(): boolean;
-    /**
-     * Handle an incoming Graph notification.
-     * Call this from your webhook endpoint after validation.
-     */
-    handleNotification(notification: GraphNotification): Promise<void>;
-    /**
-     * Check if a request is a validation request from Graph.
-     */
-    static isValidationRequest(query: Record<string, unknown>): query is GraphValidationRequest;
-    /**
-     * Validate the notification body structure.
-     */
-    static validateNotification(body: unknown): body is GraphNotification;
-}
-/**
- * Express/Fastify-compatible middleware for handling Outlook Graph webhooks.
- *
- * Handles both:
- * - Subscription validation (GET with validationToken)
- * - Notification processing (POST with notification payload)
- */
-export declare function createOutlookWebhookHandler(trigger: OutlookTrigger): (req: {
-    method: string;
-    query: Record<string, unknown>;
-    body: unknown;
-}, res: {
-    status: (code: number) => {
-        send: (body?: string) => void;
-    };
-    contentType: (type: string) => void;
-}) => Promise<void>;
-//# sourceMappingURL=outlook-trigger.d.ts.map

package/dist/services/outlook.d.ts

@@ -1,237 +0,0 @@
-import { Client } from '@microsoft/microsoft-graph-client';
-import { SDKInitializer } from '@marktoflow/core';
-export interface OutlookEmail {
-    id: string;
-    conversationId: string;
-    subject: string;
-    from: string;
-    fromAddress: string;
-    to: {
-        name: string;
-        address: string;
-    }[];
-    cc?: {
-        name: string;
-        address: string;
-    }[];
-    bcc?: {
-        name: string;
-        address: string;
-    }[];
-    receivedDateTime: string;
-    sentDateTime?: string;
-    bodyPreview: string;
-    body?: string;
-    bodyHtml?: string;
-    isRead: boolean;
-    hasAttachments: boolean;
-    importance: 'low' | 'normal' | 'high';
-    categories: string[];
-    webLink?: string;
-}
-export interface GetEmailsOptions {
-    folder?: string;
-    filter?: string;
-    select?: string[];
-    top?: number;
-    skip?: number;
-    orderBy?: string;
-    search?: string;
-}
-export interface SendEmailOptions {
-    to: string | string[] | {
-        name?: string;
-        address: string;
-    }[];
-    subject: string;
-    body: string;
-    bodyType?: 'text' | 'html';
-    cc?: string | string[] | {
-        name?: string;
-        address: string;
-    }[];
-    bcc?: string | string[] | {
-        name?: string;
-        address: string;
-    }[];
-    importance?: 'low' | 'normal' | 'high';
-    saveToSentItems?: boolean;
-    replyTo?: string | {
-        name?: string;
-        address: string;
-    }[];
-}
-export interface CreateDraftOptions {
-    to?: string | string[] | {
-        name?: string;
-        address: string;
-    }[];
-    subject?: string;
-    body?: string;
-    bodyType?: 'text' | 'html';
-    cc?: string | string[] | {
-        name?: string;
-        address: string;
-    }[];
-    bcc?: string | string[] | {
-        name?: string;
-        address: string;
-    }[];
-    importance?: 'low' | 'normal' | 'high';
-}
-export interface CalendarEvent {
-    id: string;
-    subject: string;
-    body?: string;
-    bodyHtml?: string;
-    start: {
-        dateTime: string;
-        timeZone: string;
-    };
-    end: {
-        dateTime: string;
-        timeZone: string;
-    };
-    location?: string;
-    attendees: {
-        name: string;
-        address: string;
-        type: string;
-    }[];
-    organizer?: {
-        name: string;
-        address: string;
-    };
-    isOnlineMeeting: boolean;
-    onlineMeetingUrl?: string;
-    webLink?: string;
-}
-export interface GetEventsOptions {
-    startDateTime?: string;
-    endDateTime?: string;
-    top?: number;
-    skip?: number;
-    filter?: string;
-    orderBy?: string;
-}
-export interface CreateEventOptions {
-    subject: string;
-    body?: string;
-    bodyType?: 'text' | 'html';
-    start: {
-        dateTime: string;
-        timeZone?: string;
-    };
-    end: {
-        dateTime: string;
-        timeZone?: string;
-    };
-    location?: string;
-    attendees?: (string | {
-        name?: string;
-        address: string;
-    })[];
-    isOnlineMeeting?: boolean;
-    reminderMinutesBeforeStart?: number;
-}
-export interface OutlookDraft {
-    id: string;
-    conversationId?: string;
-    webLink?: string;
-}
-export interface GetEmailsResult {
-    emails: OutlookEmail[];
-    nextLink?: string;
-}
-/**
- * Outlook actions for workflow integration (Email + Calendar)
- */
-export declare class OutlookActions {
-    private client;
-    constructor(client: Client);
-    /**
-     * Get emails from Outlook mailbox
-     */
-    getEmails(options?: GetEmailsOptions): Promise<GetEmailsResult>;
-    /**
-     * Get a specific email by ID
-     */
-    getEmail(id: string): Promise<OutlookEmail>;
-    /**
-     * Send an email via Outlook
-     */
-    sendEmail(options: SendEmailOptions): Promise<void>;
-    /**
-     * Create a draft email in Outlook
-     */
-    createDraft(options: CreateDraftOptions): Promise<OutlookDraft>;
-    /**
-     * Reply to an email
-     */
-    reply(messageId: string, body: string, bodyType?: 'text' | 'html', replyAll?: boolean): Promise<void>;
-    /**
-     * Forward an email
-     */
-    forward(messageId: string, to: string | string[] | {
-        name?: string;
-        address: string;
-    }[], comment?: string): Promise<void>;
-    /**
-     * Mark an email as read
-     */
-    markAsRead(id: string): Promise<void>;
-    /**
-     * Mark an email as unread
-     */
-    markAsUnread(id: string): Promise<void>;
-    /**
-     * Move an email to a folder
-     */
-    moveToFolder(messageId: string, destinationFolderId: string): Promise<void>;
-    /**
-     * Delete an email (move to deleted items)
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * List mail folders
-     */
-    listFolders(): Promise<{
-        id: string;
-        displayName: string;
-        totalItemCount: number;
-    }[]>;
-    /**
-     * Get calendar events
-     */
-    getEvents(options?: GetEventsOptions): Promise<CalendarEvent[]>;
-    /**
-     * Get a specific calendar event by ID
-     */
-    getEvent(id: string): Promise<CalendarEvent>;
-    /**
-     * Create a calendar event
-     */
-    createEvent(options: CreateEventOptions): Promise<CalendarEvent>;
-    /**
-     * Update a calendar event
-     */
-    updateEvent(id: string, updates: Partial<CreateEventOptions>): Promise<CalendarEvent>;
-    /**
-     * Delete a calendar event
-     */
-    deleteEvent(id: string): Promise<void>;
-    /**
-     * Accept a meeting invitation
-     */
-    acceptEvent(id: string, comment?: string, sendResponse?: boolean): Promise<void>;
-    /**
-     * Decline a meeting invitation
-     */
-    declineEvent(id: string, comment?: string, sendResponse?: boolean): Promise<void>;
-    /**
-     * Tentatively accept a meeting invitation
-     */
-    tentativelyAcceptEvent(id: string, comment?: string, sendResponse?: boolean): Promise<void>;
-}
-export declare const OutlookInitializer: SDKInitializer;
-//# sourceMappingURL=outlook.d.ts.map

package/dist/services/postgres.d.ts

@@ -1,83 +0,0 @@
-/**
- * PostgreSQL Integration
- *
- * Popular open-source relational database.
- * API: Using node-postgres (pg) driver
- */
-import { SDKInitializer } from '@marktoflow/core';
-export interface PostgresConfig {
-    host: string;
-    port?: number;
-    database: string;
-    user: string;
-    password: string;
-    ssl?: boolean | {
-        rejectUnauthorized?: boolean;
-    };
-    connectionTimeoutMillis?: number;
-    idleTimeoutMillis?: number;
-    max?: number;
-}
-export interface QueryResult<T = unknown> {
-    rows: T[];
-    rowCount: number;
-    command: string;
-    fields: {
-        name: string;
-        dataTypeID: number;
-    }[];
-}
-export interface PostgresTransaction {
-    query<T = unknown>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
-    commit(): Promise<void>;
-    rollback(): Promise<void>;
-}
-/**
- * PostgreSQL client wrapper for workflow integration
- * Note: This is a lightweight wrapper. The actual pg module will be dynamically imported.
- */
-export declare class PostgresClient {
-    private pool;
-    private config;
-    constructor(config: PostgresConfig);
-    /**
-     * Initialize the connection pool
-     */
-    connect(): Promise<void>;
-    /**
-     * Execute a SQL query
-     */
-    query<T = unknown>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
-    /**
-     * Select data from a table
-     */
-    select<T = Record<string, unknown>>(table: string, options?: {
-        columns?: string[];
-        where?: Record<string, unknown>;
-        orderBy?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<T[]>;
-    /**
-     * Insert data into a table
-     */
-    insert<T = Record<string, unknown>>(table: string, data: Record<string, unknown> | Record<string, unknown>[], returning?: string[]): Promise<T[]>;
-    /**
-     * Update data in a table
-     */
-    update<T = Record<string, unknown>>(table: string, data: Record<string, unknown>, where: Record<string, unknown>, returning?: string[]): Promise<T[]>;
-    /**
-     * Delete data from a table
-     */
-    delete<T = Record<string, unknown>>(table: string, where: Record<string, unknown>, returning?: string[]): Promise<T[]>;
-    /**
-     * Begin a transaction
-     */
-    transaction<T>(callback: (trx: PostgresTransaction) => Promise<T>): Promise<T>;
-    /**
-     * Close the connection pool
-     */
-    close(): Promise<void>;
-}
-export declare const PostgresInitializer: SDKInitializer;
-//# sourceMappingURL=postgres.d.ts.map

package/dist/services/rss.d.ts

@@ -1,57 +0,0 @@
-/**
- * RSS/Atom Feed Integration
- *
- * Fetch and parse RSS 2.0 and Atom feeds for workflow automation.
- * No authentication required for public feeds; supports custom headers for private feeds.
- */
-import { SDKInitializer } from '@marktoflow/core';
-export interface RssFeedItem {
-    title: string;
-    link: string;
-    description: string;
-    pubDate: string;
-    guid: string;
-    author: string;
-    categories: string[];
-}
-export interface RssFeed {
-    title: string;
-    description: string;
-    link: string;
-    language: string;
-    lastBuildDate: string;
-    items: RssFeedItem[];
-}
-export interface FetchFeedOptions {
-    url: string;
-    headers?: Record<string, string>;
-    timeout?: number;
-}
-export interface GetItemsOptions extends FetchFeedOptions {
-    /** Only return items published after this date */
-    since?: string | Date;
-    /** Only return items matching this regex pattern (tested against title) */
-    filter?: string;
-    /** Maximum number of items to return */
-    maxItems?: number;
-}
-export declare class RssClient {
-    private parser;
-    private defaultHeaders;
-    private defaultTimeout;
-    constructor(options?: {
-        headers?: Record<string, string>;
-        timeout?: number;
-    });
-    fetch(options: FetchFeedOptions): Promise<RssFeed>;
-    getItems(options: GetItemsOptions): Promise<RssFeedItem[]>;
-    private normalizeFeed;
-    private normalizeRssItem;
-    private normalizeAtomEntry;
-    private text;
-    private atomLink;
-    private atomAuthor;
-    private toArray;
-}
-export declare const RssInitializer: SDKInitializer;
-//# sourceMappingURL=rss.d.ts.map

package/dist/services/rss.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rss.d.ts","sourceRoot":"","sources":["../../src/services/rss.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAc,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAI9D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAUtE,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BlD,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAwBhE,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,OAAO;CAKhB;AAID,eAAO,MAAM,cAAc,EAAE,cA4B5B,CAAC"}

package/dist/services/rss.js

@@ -1,190 +0,0 @@
-/**
- * RSS/Atom Feed Integration
- *
- * Fetch and parse RSS 2.0 and Atom feeds for workflow automation.
- * No authentication required for public feeds; supports custom headers for private feeds.
- */
-import { XMLParser } from 'fast-xml-parser';
-// ── Client ───────────────────────────────────────────────────────────────────
-export class RssClient {
-    parser;
-    defaultHeaders;
-    defaultTimeout;
-    constructor(options) {
-        this.parser = new XMLParser({
-            ignoreAttributes: false,
-            attributeNamePrefix: '@_',
-            textNodeName: '#text',
-        });
-        this.defaultHeaders = options?.headers ?? {};
-        this.defaultTimeout = options?.timeout ?? 30_000;
-    }
-    async fetch(options) {
-        const { url, headers, timeout } = options;
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), timeout ?? this.defaultTimeout);
-        try {
-            const res = await global.fetch(url, {
-                headers: {
-                    Accept: 'application/rss+xml, application/atom+xml, application/xml, text/xml',
-                    ...this.defaultHeaders,
-                    ...headers,
-                },
-                signal: controller.signal,
-            });
-            if (!res.ok) {
-                throw new Error(`RSS fetch failed: ${res.status} ${res.statusText}`);
-            }
-            const xml = await res.text();
-            const parsed = this.parser.parse(xml);
-            return this.normalizeFeed(parsed, url);
-        }
-        finally {
-            clearTimeout(timer);
-        }
-    }
-    async getItems(options) {
-        const feed = await this.fetch(options);
-        let items = feed.items;
-        if (options.since) {
-            const sinceDate = new Date(options.since);
-            items = items.filter((item) => {
-                if (!item.pubDate)
-                    return true;
-                return new Date(item.pubDate) > sinceDate;
-            });
-        }
-        if (options.filter) {
-            const re = new RegExp(options.filter, 'i');
-            items = items.filter((item) => re.test(item.title));
-        }
-        if (options.maxItems !== undefined) {
-            items = items.slice(0, options.maxItems);
-        }
-        return items;
-    }
-    normalizeFeed(parsed, url) {
-        // Atom feed
-        if (parsed.feed) {
-            const feed = parsed.feed;
-            const entries = this.toArray(feed.entry);
-            return {
-                title: this.text(feed.title),
-                description: this.text(feed.subtitle) || this.text(feed.title),
-                link: this.atomLink(feed.link) || url,
-                language: feed['@_xml:lang'] ?? '',
-                lastBuildDate: this.text(feed.updated) || '',
-                items: entries.map((e) => this.normalizeAtomEntry(e)),
-            };
-        }
-        // RSS 2.0
-        const channel = parsed.rss?.channel;
-        if (!channel) {
-            return { title: '', description: '', link: url, language: '', lastBuildDate: '', items: [] };
-        }
-        const rawItems = this.toArray(channel.item);
-        return {
-            title: this.text(channel.title),
-            description: this.text(channel.description),
-            link: this.text(channel.link) || url,
-            language: channel.language ?? '',
-            lastBuildDate: this.text(channel.lastBuildDate) || '',
-            items: rawItems.map((item) => this.normalizeRssItem(item)),
-        };
-    }
-    normalizeRssItem(item) {
-        return {
-            title: this.text(item.title),
-            link: this.text(item.link),
-            description: this.text(item.description),
-            pubDate: this.text(item.pubDate),
-            guid: this.text(item.guid) || this.text(item.link),
-            author: this.text(item.author) || this.text(item['dc:creator']),
-            categories: this.toArray(item.category).map((c) => this.text(c)),
-        };
-    }
-    normalizeAtomEntry(entry) {
-        return {
-            title: this.text(entry.title),
-            link: this.atomLink(entry.link) || this.text(entry.link),
-            description: this.text(entry.summary) || this.text(entry.content),
-            pubDate: this.text(entry.updated) || this.text(entry.published),
-            guid: this.text(entry.id),
-            author: this.atomAuthor(entry.author),
-            categories: this.toArray(entry.category).map((c) => typeof c === 'object' && c !== null ? c['@_term'] ?? '' : this.text(c)),
-        };
-    }
-    text(val) {
-        if (val === undefined || val === null)
-            return '';
-        if (typeof val === 'string')
-            return val;
-        if (typeof val === 'number')
-            return String(val);
-        if (typeof val === 'object' && val !== null && '#text' in val) {
-            return String(val['#text']);
-        }
-        return String(val);
-    }
-    atomLink(val) {
-        if (!val)
-            return '';
-        if (typeof val === 'string')
-            return val;
-        if (Array.isArray(val)) {
-            const alt = val.find((l) => l['@_rel'] === 'alternate');
-            const link = alt ?? val[0];
-            return link?.['@_href'] ?? '';
-        }
-        if (typeof val === 'object') {
-            return val['@_href'] ?? '';
-        }
-        return '';
-    }
-    atomAuthor(val) {
-        if (!val)
-            return '';
-        if (typeof val === 'string')
-            return val;
-        if (typeof val === 'object' && val !== null) {
-            return this.text(val.name);
-        }
-        return '';
-    }
-    toArray(val) {
-        if (!val)
-            return [];
-        if (Array.isArray(val))
-            return val;
-        return [val];
-    }
-}
-// ── Initializer ──────────────────────────────────────────────────────────────
-export const RssInitializer = {
-    async initialize(_module, config) {
-        const headers = config.options?.['headers'];
-        const timeout = config.options?.['timeout'];
-        const client = new RssClient({ headers, timeout });
-        return {
-            client,
-            fetch: async (inputs) => {
-                return client.fetch({
-                    url: inputs.url,
-                    headers: inputs.headers,
-                    timeout: inputs.timeout,
-                });
-            },
-            getItems: async (inputs) => {
-                return client.getItems({
-                    url: inputs.url,
-                    headers: inputs.headers,
-                    timeout: inputs.timeout,
-                    since: inputs.since,
-                    filter: inputs.filter,
-                    maxItems: inputs.maxItems,
-                });
-            },
-        };
-    },
-};
-//# sourceMappingURL=rss.js.map