flow-frame-core 0.1.0

package/dist/filter-gmail-poller/README.md

@@ -0,0 +1,320 @@
+# Filter Gmail Poller
+
+A specialized Gmail poller that filters emails by subject prefix, maintains an in-memory cache of recent emails, and provides a REST API for accessing filtered emails.
+
+## Features
+
+- 🎯 **Subject Prefix Filtering** - Only processes emails with specific subject prefixes
+- 💾 **In-Memory Cache** - Keeps the last N emails in memory for fast access
+- 🌐 **REST API** - HTTP endpoints to retrieve filtered emails
+- 🔄 **Continuous Polling** - Regularly checks for new emails matching the filter
+- 📊 **Statistics & Health Checks** - API endpoints for monitoring
+
+## Configuration
+
+Edit `config.json` to customize behavior:
+
+```json
+{
+  "gmail": {
+    "credentialsPath": "../gmail-poller/credentials.json",
+    "scopes": ["https://www.googleapis.com/auth/gmail.readonly"]
+  },
+  "filter": {
+    "subjectPrefix": "[FILTER]",
+    "maxEmailsInMemory": 50,
+    "pollingIntervalMs": 30000
+  },
+  "api": {
+    "port": 3001,
+    "host": "localhost"
+  },
+  "logging": {
+    "level": "info",
+    "enableConsole": true
+  }
+}
+```
+
+## Setup
+
+### 1. Install Dependencies
+
+The dependencies are already installed in the main midjourney project.
+
+### 2. Set up Gmail Authentication
+
+Make sure Gmail credentials are set up in the parent `gmail-poller` folder:
+
+```bash
+cd ../gmail-poller
+node setup-auth.js
+```
+
+### 3. Configure Filter
+
+Edit `config.json` to set your desired subject prefix and other settings.
+
+## Usage
+
+### Standalone Server
+
+Run as a standalone server (creates its own Express app):
+
+```bash
+node index.js
+```
+
+### Integration with Existing Express App
+
+Integrate with your existing Express application:
+
+```javascript
+import express from 'express';
+import { FilterGmailPoller } from './path/to/filter-gmail-poller/index.js';
+
+const app = express();
+// ... your existing middleware and routes ...
+
+const poller = new FilterGmailPoller();
+
+// Initialize (authenticates once, starts API server)
+await poller.initialize(app);
+
+// Start polling when ready
+await poller.startPolling();
+
+// Stop polling when needed
+poller.stopPolling();
+
+// Start polling again later
+await poller.startPolling();
+```
+
+### Programmatic Control
+
+Control polling programmatically:
+
+```javascript
+import { FilterGmailPoller } from './filter-gmail-poller/index.js';
+
+const poller = new FilterGmailPoller();
+
+// Initialize (authenticates once)
+await poller.initialize();
+
+// Check status
+console.log('Is polling:', poller.pollingInterval !== null);
+console.log('Is authenticated:', poller.isAuthenticated);
+
+// Start/stop polling as needed
+await poller.startPolling();
+poller.stopPolling();
+```
+
+app.listen(3000, () => {
+  console.log('Server running with Gmail poller integrated');
+});
+```
+
+See `example-existing-app.js` for a complete integration example.
+
+### API Endpoints
+
+#### Get Filtered Emails
+```
+GET /api/emails
+GET /api/emails?limit=10
+```
+
+Returns the most recent filtered emails.
+
+#### Get Specific Email
+```
+GET /api/emails/{emailId}
+```
+
+Returns a specific email by ID.
+
+#### Get Statistics
+```
+GET /api/stats
+```
+
+Returns poller statistics and configuration.
+
+#### Get Configuration
+```
+GET /api/config
+```
+
+Returns the current configuration settings.
+
+#### Start Polling
+```
+POST /api/polling/start
+```
+
+Starts the email polling process. If this is the first time polling is started, Gmail authentication will occur automatically. Subsequent calls will reuse the existing authentication.
+
+#### Stop Polling
+```
+POST /api/polling/stop
+```
+
+Stops the email polling process.
+
+#### Get Polling Status
+```
+GET /api/polling/status
+```
+
+Returns the current polling status and authentication state.
+
+#### Check If Polling
+```
+GET /api/polling
+```
+
+Returns a simple boolean indicating if the poller is currently active.
+
+#### Update Filter Configuration
+```
+PUT /api/config/filter
+Content-Type: application/json
+
+{
+  "subjectPrefix": "[NEW_PREFIX]",
+  "maxEmailsInMemory": 100,
+  "pollingIntervalMs": 60000
+}
+```
+
+Updates the filter configuration and saves it to the config file. Only provided fields will be updated.
+
+## Example API Usage
+
+```javascript
+// Initialize poller (no authentication yet)
+const poller = new FilterGmailPoller();
+await poller.initialize();
+
+// First call to start polling triggers authentication
+await fetch('http://localhost:3001/api/polling/start', { method: 'POST' });
+// Authentication happens here automatically
+
+// Check status
+const statusResponse = await fetch('http://localhost:3001/api/polling/status');
+const status = await statusResponse.json();
+console.log('Is authenticated:', status.isAuthenticated);
+console.log('Is polling:', status.isPolling);
+
+// Check if polling (simple boolean)
+const pollingResponse = await fetch('http://localhost:3001/api/polling');
+const pollingStatus = await pollingResponse.json();
+console.log('Currently polling:', pollingStatus.isPolling);
+
+// Stop polling
+await fetch('http://localhost:3001/api/polling/stop', { method: 'POST' });
+
+// Start polling again (no re-authentication)
+await fetch('http://localhost:3001/api/polling/start', { method: 'POST' });
+
+// Get recent filtered emails
+const emailsResponse = await fetch('http://localhost:3001/api/emails');
+const emailsData = await emailsResponse.json();
+```
+
+## Files
+
+- `config.json` - Configuration file
+- `filter-gmail-poller.js` - Main poller class
+- `index.js` - Entry point for standalone usage
+- `test.js` - Test suite
+- `demo.js` - Interactive demo
+- `example-existing-app.js` - Example of integration with existing Express app
+- `README.md` - This documentation
+
+1. **Authentication**: Uses OAuth2 credentials from the parent `gmail-poller` folder
+2. **Polling**: Regularly queries Gmail for recent emails (last 24 hours)
+3. **Filtering**: Checks each email's subject against the configured prefix
+4. **Caching**: Stores matching emails in memory (most recent first)
+5. **API**: Provides HTTP endpoints to access the cached emails
+
+## Authentication & Polling Control
+
+### Authentication
+- **Lazy authentication**: Gmail authentication occurs only when polling starts for the first time
+- **One-time process**: Authentication happens once and persists across polling start/stop cycles
+- **Delayed initialization**: No authentication overhead until polling is actually needed
+- **Token management**: OAuth2 tokens are managed automatically by the Google APIs client
+
+### Polling Control
+- **Independent polling**: Start and stop email polling without affecting authentication
+- **Automatic auth**: First call to `startPolling()` triggers authentication if not already authenticated
+- **API control**: Use REST endpoints to control polling remotely
+- **Programmatic control**: Call `startPolling()` and `stopPolling()` methods directly
+- **Status monitoring**: Check polling status via `/api/polling/status` endpoint
+
+### Usage Pattern
+```javascript
+const poller = new FilterGmailPoller();
+
+// Initialize (no authentication yet)
+await poller.initialize();
+
+// First call to startPolling triggers authentication
+await poller.startPolling();  // ← Authentication happens here
+
+// Subsequent calls don't re-authenticate
+poller.stopPolling();         // Stop polling
+await poller.startPolling();  // Start again (no re-auth needed)
+```
+
+## Configuration Updates
+
+### Programmatic Updates
+
+You can update filter configuration programmatically:
+
+```javascript
+// Update subject prefix
+await poller.updateFilterConfig({
+  subjectPrefix: '[IMPORTANT]'
+});
+
+// Update multiple settings
+await poller.updateFilterConfig({
+  subjectPrefix: '[ALERT]',
+  maxEmailsInMemory: 100,
+  pollingIntervalMs: 60000
+});
+```
+
+### API Updates
+
+Update configuration via REST API:
+
+```bash
+curl -X PUT http://localhost:3001/api/config/filter \
+  -H "Content-Type: application/json" \
+  -d '{
+    "subjectPrefix": "[NEW_FILTER]",
+    "maxEmailsInMemory": 75,
+    "pollingIntervalMs": 45000
+  }'
+```
+
+### Automatic Saving
+
+All configuration updates are automatically saved to `config.json` and persist across restarts.
+
+## Dependencies
+
+- `express` - API server
+- `cors` - Cross-origin requests
+- Gmail API credentials (from parent folder)
+
+## License
+
+MIT

package/dist/filter-gmail-poller/demo.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=demo.d.ts.map

package/dist/filter-gmail-poller/demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../../src/filter-gmail-poller/demo.ts"],"names":[],"mappings":""}

package/dist/filter-gmail-poller/demo.js

@@ -0,0 +1,79 @@
+import FilterGmailPoller from './filter-gmail-poller.js';
+async function demo() {
+    console.log('🎯 Filter Gmail Poller Demo');
+    console.log('===========================\n');
+    const poller = new FilterGmailPoller();
+    try {
+        // Load config and authenticate
+        await poller.loadConfig();
+        await poller.authenticate();
+        console.log('📧 Current filter configuration:');
+        console.log(`   Subject prefix: "${poller.config.filter.subjectPrefix}"`);
+        console.log(`   Max emails: ${poller.config.filter.maxEmailsInMemory}`);
+        console.log(`   Poll interval: ${poller.config.filter.pollingIntervalMs}ms\n`);
+        // Start API server
+        await poller.startAPIServer();
+        // Do an initial poll
+        console.log('🔍 Performing initial email scan...');
+        await poller.pollAndFilter();
+        const emails = poller.getEmails();
+        console.log(`📬 Found ${emails.length} emails matching filter\n`);
+        // Show sample API calls
+        console.log('🌐 API Demo:');
+        console.log('-----------');
+        // Health check
+        const healthResponse = await fetch(`http://localhost:3001/api/health`);
+        const health = await healthResponse.json();
+        console.log('✅ Health check:', health.success ? 'OK' : 'FAIL');
+        // Get stats
+        const statsResponse = await fetch(`http://localhost:3001/api/stats`);
+        const stats = await statsResponse.json();
+        console.log('📊 Stats:', JSON.stringify(stats.stats, null, 2));
+        // Get emails
+        const emailsResponse = await fetch(`http://localhost:3001/api/emails?limit=5`);
+        const emailsData = await emailsResponse.json();
+        console.log(`📧 Emails API returned ${emailsData.count} emails`);
+        if (emailsData.emails.length > 0) {
+            console.log('\n📋 Sample filtered email:');
+            const sampleEmail = emailsData.emails[0];
+            console.log(`   Subject: ${sampleEmail.subject}`);
+            console.log(`   Filtered at: ${sampleEmail.filteredAt}`);
+        }
+        // Test configuration update
+        console.log('\n⚙️ Testing configuration update...');
+        const configUpdate = await fetch('http://localhost:3001/api/config/filter', {
+            method: 'PUT',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                subjectPrefix: '[UPDATED]',
+                maxEmailsInMemory: 25,
+                pollingIntervalMs: 45000
+            })
+        });
+        const configResult = await configUpdate.json();
+        if (configResult.success) {
+            console.log('✅ Configuration updated via API:');
+            console.log(`   New prefix: "${configResult.newConfig.subjectPrefix}"`);
+            console.log(`   New max emails: ${configResult.newConfig.maxEmailsInMemory}`);
+            console.log(`   New interval: ${configResult.newConfig.pollingIntervalMs}ms`);
+        }
+        console.log('\n🎉 Demo completed successfully!');
+        console.log('\n💡 To use with real emails:');
+        console.log('   1. Send emails with subject starting with "[FILTER]"');
+        console.log('   2. Run: node index.js');
+        console.log('   3. Access API at http://localhost:3001');
+    }
+    catch (error) {
+        console.error('❌ Demo failed:', error);
+    }
+    finally {
+        // Clean up
+        poller.stopAPIServer();
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    demo();
+}
+//# sourceMappingURL=demo.js.map

package/dist/filter-gmail-poller/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.js","sourceRoot":"","sources":["../../src/filter-gmail-poller/demo.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAEvC,IAAI,CAAC;QACH,+BAA+B;QAC/B,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QAE5B,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,MAAM,CAAC,CAAC;QAE/E,mBAAmB;QACnB,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;QAE9B,qBAAqB;QACrB,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACnD,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAE7B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,2BAA2B,CAAC,CAAC;QAElE,wBAAwB;QACxB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAE3B,eAAe;QACf,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAE/D,YAAY;QACZ,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE/D,aAAa;QACb,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC/E,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,0BAA0B,UAAU,CAAC,KAAK,SAAS,CAAC,CAAC;QAEjE,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAC3C,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,eAAe,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,mBAAmB,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,4BAA4B;QAC5B,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,yCAAyC,EAAE;YAC1E,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,aAAa,EAAE,WAAW;gBAC1B,iBAAiB,EAAE,EAAE;gBACrB,iBAAiB,EAAE,KAAK;aACzB,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,mBAAmB,YAAY,CAAC,SAAS,CAAC,aAAa,GAAG,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,CAAC,sBAAsB,YAAY,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,oBAAoB,YAAY,CAAC,SAAS,CAAC,iBAAiB,IAAI,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAE3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;YAAS,CAAC;QACT,WAAW;QACX,MAAM,CAAC,aAAa,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/filter-gmail-poller/example-existing-app.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=example-existing-app.d.ts.map

package/dist/filter-gmail-poller/example-existing-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-existing-app.d.ts","sourceRoot":"","sources":["../../src/filter-gmail-poller/example-existing-app.ts"],"names":[],"mappings":""}

package/dist/filter-gmail-poller/example-existing-app.js

@@ -0,0 +1,72 @@
+import express from 'express';
+import cors from 'cors';
+import { FilterGmailPoller } from './index.js';
+async function exampleWithExistingApp() {
+    console.log('🚀 Example: Filter Gmail Poller with Existing Express App');
+    console.log('==================================================\n');
+    // Create your existing Express app
+    const app = express();
+    app.use(cors());
+    app.use(express.json());
+    // Add your own routes
+    app.get('/', (req, res) => {
+        res.json({
+            message: 'Main application API',
+            endpoints: [
+                'GET / - This message',
+                'GET /api/emails - Gmail poller emails',
+                'GET /api/stats - Gmail poller stats',
+                'PUT /api/config/filter - Update Gmail poller config'
+            ]
+        });
+    });
+    app.get('/custom-route', (req, res) => {
+        res.json({
+            message: 'This is a custom route in your main app',
+            timestamp: new Date().toISOString()
+        });
+    });
+    // Create and initialize the Gmail poller with your existing app
+    const poller = new FilterGmailPoller();
+    try {
+        // Initialize the poller (sets up API routes, no authentication yet)
+        await poller.initialize(app);
+        // Start polling (authentication will occur here on first start)
+        await poller.startPolling();
+        // Example: Stop polling after 30 seconds, then restart after 10 seconds
+        setTimeout(() => {
+            console.log('\n⏹️ Stopping polling for demonstration...');
+            poller.stopPolling();
+        }, 30000);
+        setTimeout(async () => {
+            console.log('\n🚀 Restarting polling...');
+            await poller.startPolling();
+        }, 40000);
+        // Start your main server
+        const PORT = 3001;
+        app.listen(PORT, () => {
+            console.log(`\n🌐 Main application server started on http://localhost:${PORT}`);
+            console.log('📊 All endpoints available:');
+            console.log('   Main App:');
+            console.log(`   GET http://localhost:${PORT}/ - Main app info`);
+            console.log(`   GET http://localhost:${PORT}/custom-route - Custom route`);
+            console.log('   Gmail Poller:');
+            console.log(`   GET http://localhost:${PORT}/api/emails - Filtered emails`);
+            console.log(`   GET http://localhost:${PORT}/api/stats - Poller stats`);
+            console.log(`   GET http://localhost:${PORT}/api/config - Current config`);
+            console.log(`   GET http://localhost:${PORT}/api/polling/status - Polling status`);
+            console.log(`   POST http://localhost:${PORT}/api/polling/start - Start polling`);
+            console.log(`   POST http://localhost:${PORT}/api/polling/stop - Stop polling`);
+            console.log(`   PUT http://localhost:${PORT}/api/config/filter - Update config`);
+            console.log('\n💡 Polling will stop after 30s and restart after 40s for demo');
+        });
+    }
+    catch (error) {
+        console.error('❌ Failed to start:', error);
+        process.exit(1);
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    exampleWithExistingApp();
+}
+//# sourceMappingURL=example-existing-app.js.map

package/dist/filter-gmail-poller/example-existing-app.js.map

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

package/dist/filter-gmail-poller/filter-gmail-poller.d.ts

@@ -0,0 +1,160 @@
+declare class FilterGmailPoller {
+    static instance: any;
+    constructor(configPath?: string);
+    /**
+     * Load configuration from JSON file
+     */
+    loadConfig(): Promise<any>;
+    /**
+     * Authenticate with Gmail API
+     */
+    authenticate(): Promise<void>;
+    /**
+     * Check if email subject starts with the configured prefix
+     */
+    matchesFilter(email: any): any;
+    /**
+     * Extract and decode email body from Gmail message
+     * @param {Object} email - Gmail message object
+     * @param {string} [preferredType='text/plain'] - Preferred MIME type ('text/plain' or 'text/html')
+     * @returns {string} - Decoded email body as string
+     */
+    extractEmailBody(email: any, preferredType?: string): string;
+    /**
+     * Extract subject from email headers
+     */
+    getEmailSubject(email: any): any;
+    /**
+     * Resolve a Gmail label ID by its display name
+     */
+    getLabelIdByName(labelName: any): Promise<any>;
+    /**
+     * Determine which label IDs to use when querying Gmail
+     */
+    getFilterLabelIds(): Promise<any[]>;
+    /**
+     * Get all labels
+     */
+    getLabels(): Promise<any>;
+    /**
+     * Create new label/folder
+     */
+    createLabel(labelName: any): Promise<any>;
+    /**
+     * Find or create label
+     */
+    findOrCreateLabel(labelName: any): Promise<any>;
+    /**
+     * Get human-like delay
+     */
+    getHumanDelay(): number;
+    /**
+     * Get full email details
+     */
+    getEmailDetails(messageId: any): Promise<any>;
+    /**
+     * Move email to different label/folder
+     */
+    moveEmail(messageId: any, targetLabelId: any, removeLabelIds?: any[]): Promise<any>;
+    /**
+     * Ensure a folder/label exists by name
+     * Returns the label object (existing or newly created)
+     */
+    ensureFolderExists(folderName: any): Promise<any>;
+    /**
+     * Move an email to a specific folder by name
+     * Automatically ensures the folder exists before moving
+     */
+    moveEmailToFolder(messageId: any, folderName: any, removeFromInbox?: boolean): Promise<any>;
+    /**
+     * Step through emails manually with pagination
+     * Ensures authentication and allows controlled processing of emails
+     * Honors the configured filter (subject prefix)
+     */
+    stepThroughEmails(options?: {}): Promise<{
+        messages: any;
+        nextPageToken: any;
+        hasMore: boolean;
+        totalMessages: any;
+        filteredMessages: number;
+        subjectPrefix: any;
+    }>;
+    /**
+     * Add email to memory (keeping only the most recent N emails)
+     */
+    addEmailToMemory(email: any): void;
+    /**
+     * Poll for new emails and filter them
+     */
+    pollAndFilter(): Promise<void>;
+    /**
+     * Start the polling process
+     */
+    startPolling(): Promise<void>;
+    /**
+     * Stop the polling process
+     */
+    stopPolling(): void;
+    /**
+     * Start the API server or integrate with existing Express app
+     * @param {Object} [existingApp] - Optional existing Express app to integrate with
+     */
+    startAPIServer(existingApp?: any): Promise<unknown>;
+    /**
+     * Stop the API server (only if we created it)
+     */
+    stopAPIServer(): void;
+    /**
+     * Authenticate with Gmail API (only once)
+     */
+    authenticateOnce(): Promise<void>;
+    /**
+     * Initialize and start everything (without auto-starting polling)
+     * @param {Object} [existingApp] - Optional existing Express app to integrate with
+     */
+    initialize(existingApp?: any): Promise<void>;
+    /**
+     * Initialize and start everything (legacy method - now calls initialize)
+     * @param {Object} [existingApp] - Optional existing Express app to integrate with
+     */
+    start(existingApp?: any): Promise<void>;
+    /**
+     * Get current emails (for testing/debugging)
+     */
+    getEmails(): any;
+    /**
+     * Update filter configuration parameters
+     * @param {Object} updates - Configuration updates
+     * @param {string} [updates.subjectPrefix] - New subject prefix
+     * @param {number} [updates.maxEmailsInMemory] - New maximum emails in memory
+     * @param {number} [updates.pollingIntervalMs] - New polling interval in milliseconds
+     */
+    updateFilterConfig(updates: any): Promise<{
+        success: boolean;
+        updated: boolean;
+        pollingRestarted: boolean;
+        newConfig: any;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: any;
+        updated?: undefined;
+        pollingRestarted?: undefined;
+        newConfig?: undefined;
+    }>;
+    /**
+     * Clear all emails from memory
+     */
+    clearEmails(): void;
+    isTextMimeType(mimeType?: string): boolean;
+    isTextExtension(filename?: string): boolean;
+    decodeToBuffer(data?: string): Buffer<ArrayBuffer>;
+    encodeToBase64Url(str?: string): string;
+    collectAttachmentParts(part: any, attachments?: any[]): any[];
+    fetchAttachmentBuffer(messageId: any, attachmentId: any): Promise<Buffer<ArrayBuffer>>;
+    parsePdfAttachment(buffer: any, messageId: any, filename?: string): Promise<string>;
+    extractAttachmentText(messageId: any, part: any): Promise<any>;
+    includeAttachmentsInBody(message: any): Promise<any>;
+}
+export default FilterGmailPoller;
+//# sourceMappingURL=filter-gmail-poller.d.ts.map

package/dist/filter-gmail-poller/filter-gmail-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-gmail-poller.d.ts","sourceRoot":"","sources":["../../src/filter-gmail-poller/filter-gmail-poller.ts"],"names":[],"mappings":"AA0BA,cAAM,iBAAiB;IACrB,MAAM,CAAC,QAAQ,MAAQ;gBACX,UAAU,SAAkB;IAWxC;;OAEG;IACG,UAAU;IAYhB;;OAEG;IACG,YAAY;IAkBlB;;OAEG;IACH,aAAa,CAAC,KAAK,KAAA;IAMnB;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,KAAA,EAAE,aAAa,SAAe;IA4DpD;;OAEG;IACH,eAAe,CAAC,KAAK,KAAA;IAUrB;;OAEG;IACG,gBAAgB,CAAC,SAAS,KAAA;IAiBhC;;OAEG;IACG,iBAAiB;IAuCvB;;OAEG;IACG,SAAS;IAiBf;;OAEG;IACG,WAAW,CAAC,SAAS,KAAA;IA0B3B;;OAEG;IACG,iBAAiB,CAAC,SAAS,KAAA;IAWjC;;OAEG;IACH,aAAa;IAMb;;OAEG;IACG,eAAe,CAAC,SAAS,KAAA;IAsB/B;;OAEG;IACG,SAAS,CAAC,SAAS,KAAA,EAAE,aAAa,KAAA,EAAE,cAAc,QAAK;IAiC7D;;;OAGG;IACG,kBAAkB,CAAC,UAAU,KAAA;IAgBnC;;;OAGG;IACG,iBAAiB,CAAC,SAAS,KAAA,EAAE,UAAU,KAAA,EAAE,eAAe,UAAO;IAwBrE;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,KAAK;;;;;;;;IAsFpC;;OAEG;IACH,gBAAgB,CAAC,KAAK,KAAA;IAqBtB;;OAEG;IACG,aAAa;IAsDnB;;OAEG;IACG,YAAY;IA2BlB;;OAEG;IACH,WAAW;IAQX;;;OAGG;IACG,cAAc,CAAC,WAAW,MAAO;IAmNvC;;OAEG;IACH,aAAa;IAYb;;OAEG;IACG,gBAAgB;IActB;;;OAGG;IACG,UAAU,CAAC,WAAW,MAAO;IA6BnC;;;OAGG;IACG,KAAK,CAAC,WAAW,MAAO;IAa9B;;OAEG;IACH,SAAS;IAIT;;;;;;OAMG;IACG,kBAAkB,CAAC,OAAO,KAAA;;;;;;;;;;;;;IA2FhC;;OAEG;IACH,WAAW;IAKX,cAAc,CAAC,QAAQ,SAAK;IAI5B,eAAe,CAAC,QAAQ,SAAK;IAK7B,cAAc,CAAC,IAAI,SAAK;IAKxB,iBAAiB,CAAC,GAAG,SAAK;IAQ1B,sBAAsB,CAAC,IAAI,KAAA,EAAE,WAAW,QAAK;IAgBvC,qBAAqB,CAAC,SAAS,KAAA,EAAE,YAAY,KAAA;IAc7C,kBAAkB,CAAC,MAAM,KAAA,EAAE,SAAS,KAAA,EAAE,QAAQ,SAAmB;IA2CjE,qBAAqB,CAAC,SAAS,KAAA,EAAE,IAAI,KAAA;IA2BrC,wBAAwB,CAAC,OAAO,KAAA;CA2CvC;AAED,eAAe,iBAAiB,CAAC"}