ai-vault 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AI Vault Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,287 @@
+# 🏛️ AI Vault
+
+**Own your data.** Open-source CLI tool for comprehensive archival of AI interactions—conversations, generated images, videos, code artifacts, and all metadata—across multiple platforms.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
+[![Node](https://img.shields.io/badge/Node-%3E%3D18.0.0-green.svg)](https://nodejs.org/)
+
+## 🎯 Mission
+
+Your AI interactions are valuable assets. They contain your thoughts, research, creative work, problem-solving, generated media, and code artifacts. But they live in siloed platforms, controlled by different companies, subject to data loss, policy changes, or account restrictions.
+
+**AI Vault** gives you back complete control with:
+
+- 🔄 **Automated daily backups** - Set it and forget it
+- 🎯 **Smart targeting** - Archive what matters, skip the noise
+- 📦 **Multi-platform support** - ChatGPT, Claude, Grok, Gemini, and more
+- 🖼️ **Complete media preservation** - Images, videos, diagrams, code artifacts with intelligent deduplication
+- 📝 **Full conversation history** - Every message, timestamp, metadata, and context
+- 🏠 **Local-first** - Your data stays on your machine, encrypted and secure
+- 🔌 **Plugin architecture** - Easy to extend with new providers
+
+## ✨ Features
+
+### Supported Platforms
+
+| Platform        | Status         | API Support | Web Scraping | Media Download |
+| --------------- | -------------- | ----------- | ------------ | -------------- |
+| **Grok (X.AI)** | 🚧 In Progress | ✅          | ✅           | ✅             |
+| **ChatGPT**     | 📋 Planned     | ✅          | ✅           | ✅             |
+| **Claude**      | 📋 Planned     | ✅          | ✅           | ✅             |
+| **Gemini**      | 📋 Planned     | ⚠️ Partial  | ✅           | ✅             |
+| **Perplexity**  | 📋 Planned     | ❌          | ✅           | ✅             |
+
+### Smart Features
+
+- **Incremental Backups** - Only fetch new/updated conversations
+- **Media Deduplication** - Don't store the same image twice
+- **Flexible Scheduling** - Daily, weekly, or custom cron expressions
+- **Rich Export Formats** - JSON, Markdown, HTML with metadata
+- **Automatic Cookie Management** - Extract session cookies from your browser
+- **Filtering & Targeting** - Date ranges, conversation importance, custom queries
+
+## 📦 Installation
+
+### Quick Install (All Platforms)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/dotCipher/ai-vault/main/install.sh | bash
+```
+
+Or with wget:
+
+```bash
+wget -qO- https://raw.githubusercontent.com/dotCipher/ai-vault/main/install.sh | bash
+```
+
+### Package Managers
+
+**npm (All Platforms)**
+
+```bash
+npm install -g ai-vault
+```
+
+**pnpm (All Platforms)**
+
+```bash
+pnpm install -g ai-vault
+```
+
+**Homebrew (macOS)**
+
+```bash
+brew install node@22
+npm install -g ai-vault
+```
+
+_Coming soon: Direct Homebrew tap for native installation without Node.js_
+
+### From Source (Development)
+
+```bash
+git clone https://github.com/dotCipher/ai-vault.git
+cd ai-vault
+pnpm install && pnpm run build
+```
+
+### Updating
+
+**npm/pnpm**
+
+```bash
+npm update -g ai-vault
+# or
+pnpm update -g ai-vault
+```
+
+**Homebrew (once tap is available)**
+
+```bash
+brew upgrade ai-vault
+```
+
+**Check current version**
+
+```bash
+ai-vault --version
+```
+
+### Uninstalling
+
+**npm/pnpm**
+
+```bash
+npm uninstall -g ai-vault
+# or
+pnpm uninstall -g ai-vault
+```
+
+**Homebrew (once tap is available)**
+
+```bash
+brew uninstall ai-vault
+```
+
+**Remove configuration and data** (optional)
+
+```bash
+# macOS/Linux
+rm -rf ~/.config/ai-vault
+rm -rf ~/ai-vault-data
+
+# Windows
+rmdir /s %APPDATA%\ai-vault
+rmdir /s %USERPROFILE%\ai-vault-data
+```
+
+## 🚀 Quick Start
+
+```bash
+# Interactive setup wizard
+ai-vault setup
+
+# Run your first archive
+ai-vault archive
+
+# Schedule automated backups
+ai-vault schedule --daily
+
+# List archived conversations
+ai-vault list
+```
+
+## 📖 Usage
+
+### Setup
+
+```bash
+ai-vault setup
+```
+
+The interactive wizard will:
+
+1. Choose which AI platforms to archive
+2. Configure authentication (API keys or browser cookies)
+3. Set your backup preferences
+4. Choose export formats
+
+### Archive Now
+
+```bash
+# Archive all configured platforms
+ai-vault archive
+
+# Archive specific platform
+ai-vault archive --provider grok
+
+# Archive with date filter
+ai-vault archive --since 2025-01-01
+
+# Dry run (see what would be archived)
+ai-vault archive --dry-run
+```
+
+### Schedule Automated Backups
+
+```bash
+# Set up daily backups
+ai-vault schedule --daily
+
+# Custom cron expression
+ai-vault schedule --cron "0 2 * * *"  # Every day at 2 AM
+
+# View scheduled jobs
+ai-vault schedule --list
+```
+
+### List Archived Conversations
+
+```bash
+# List all archived conversations
+ai-vault list
+
+# Filter by provider
+ai-vault list --provider chatgpt
+
+# Search by keyword
+ai-vault list --search "machine learning"
+```
+
+## 🏗️ Architecture
+
+AI Vault uses a **plugin-based provider architecture** that makes it easy to add new AI platforms:
+
+```
+src/
+├── providers/          # Pluggable AI platform providers
+│   ├── base.ts        # Abstract Provider interface
+│   ├── grok/          # Grok (X.AI) implementation
+│   ├── chatgpt/       # ChatGPT implementation
+│   └── claude/        # Claude implementation
+├── core/              # Core archival logic
+│   ├── archiver.ts    # Main archival orchestration
+│   ├── storage.ts     # Local storage management
+│   ├── media.ts       # Media download & dedup
+│   └── scheduler.ts   # Backup scheduling
+├── cli/               # CLI commands
+└── types/             # Shared TypeScript types
+```
+
+See [ARCHITECTURE.md](docs/architecture.md) for details.
+
+## 🤝 Contributing
+
+We welcome contributions! Whether you want to:
+
+- Add support for a new AI platform
+- Improve existing providers
+- Add features or fix bugs
+- Improve documentation
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Adding a New Provider
+
+Adding a new AI platform takes ~30 minutes:
+
+1. Copy `src/providers/_template/` to your new provider
+2. Implement the `Provider` interface
+3. Add authentication method
+4. Implement conversation fetching
+5. Add tests and documentation
+
+See [docs/providers.md](docs/providers.md) for a detailed guide.
+
+## 📋 Roadmap
+
+- [x] Project setup and architecture
+- [ ] Grok provider (API + scraping)
+- [ ] ChatGPT provider
+- [ ] Claude provider
+- [ ] Media downloader with deduplication
+- [ ] Smart filtering system
+- [ ] Scheduling with cron/launchd
+- [ ] Gemini provider
+- [ ] Perplexity provider
+- [ ] Export to knowledge management tools (Obsidian, Notion)
+- [ ] Search across all archived conversations
+- [ ] Web UI for browsing archives
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## 🙏 Acknowledgments
+
+Built with:
+
+- [Playwright](https://playwright.dev/) - Web automation
+- [Commander.js](https://github.com/tj/commander.js) - CLI framework
+- [Clack](https://github.com/natemoo-re/clack) - Interactive prompts
+- [Zod](https://zod.dev/) - Schema validation
+
+---
+
+**Remember:** Your data is yours. Keep it safe. 🏛️

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * AI Vault CLI
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * AI Vault CLI
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+const program = new Command();
+program
+    .name('ai-vault')
+    .description('Own your data. Archive AI conversations across multiple platforms.')
+    .version('1.0.0');
+program
+    .command('setup')
+    .description('Interactive setup wizard')
+    .action(async () => {
+    console.log(chalk.blue('Setup wizard coming soon!'));
+    console.log(chalk.gray('This will help you configure providers and authentication.'));
+});
+program
+    .command('archive')
+    .description('Archive conversations from configured providers')
+    .option('-p, --provider <provider>', 'Specific provider to archive')
+    .option('--since <date>', 'Archive conversations since date')
+    .option('--dry-run', 'Preview what would be archived without downloading')
+    .action(async (options) => {
+    console.log(chalk.blue('Archive command coming soon!'));
+    console.log(chalk.gray('Options:'), options);
+});
+program
+    .command('list')
+    .description('List archived conversations')
+    .option('-p, --provider <provider>', 'Filter by provider')
+    .option('--search <query>', 'Search conversations')
+    .action(async (options) => {
+    console.log(chalk.blue('List command coming soon!'));
+    console.log(chalk.gray('Options:'), options);
+});
+program
+    .command('schedule')
+    .description('Configure automated backup schedule')
+    .option('--daily', 'Schedule daily backups')
+    .option('--cron <expression>', 'Custom cron expression')
+    .option('--list', 'List scheduled jobs')
+    .action(async (options) => {
+    console.log(chalk.blue('Schedule command coming soon!'));
+    console.log(chalk.gray('Options:'), options);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,oEAAoE,CAAC;KACjF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC,CAAC;AACxF,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,iDAAiD,CAAC;KAC9D,MAAM,CAAC,2BAA2B,EAAE,8BAA8B,CAAC;KACnE,MAAM,CAAC,gBAAgB,EAAE,kCAAkC,CAAC;KAC5D,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC;KACzE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,2BAA2B,EAAE,oBAAoB,CAAC;KACzD,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;KAClD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,SAAS,EAAE,wBAAwB,CAAC;KAC3C,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC;KACvD,MAAM,CAAC,QAAQ,EAAE,qBAAqB,CAAC;KACvC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/providers/_template/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Template for creating new AI platform providers
+ *
+ * To create a new provider:
+ * 1. Copy this directory to src/providers/yourplatform/
+ * 2. Rename the class and implement all methods
+ * 3. Add provider name to types/index.ts ProviderName type
+ * 4. Register in src/providers/index.ts
+ * 5. Create documentation in docs/providers/yourplatform.md
+ */
+import { BaseProvider } from '../base';
+import type { ProviderConfig, Conversation } from '../../types';
+import type { ListConversationsOptions, ConversationSummary } from '../../types/provider';
+export declare class TemplateProvider extends BaseProvider {
+    readonly name: any;
+    readonly displayName = "Template Provider";
+    readonly supportedAuthMethods: ('api-key' | 'cookies' | 'oauth')[];
+    /**
+     * Authenticate with the provider
+     */
+    authenticate(config: ProviderConfig): Promise<boolean>;
+    /**
+     * Check if currently authenticated
+     */
+    isAuthenticated(): Promise<boolean>;
+    /**
+     * List all conversations
+     */
+    listConversations(options?: ListConversationsOptions): Promise<ConversationSummary[]>;
+    /**
+     * Fetch complete conversation with all messages
+     */
+    fetchConversation(id: string): Promise<Conversation>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/_template/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/_template/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG1F,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,IAAI,EAAa,GAAG,CAAC;IAC9B,QAAQ,CAAC,WAAW,uBAAuB;IAC3C,QAAQ,CAAC,oBAAoB,EAAE,CAAC,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,EAAE,CAA0B;IAE5F;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAsC5D;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAYzC;;OAEG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAqC3F;;OAEG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CA4D3D"}

package/dist/providers/_template/index.js

@@ -0,0 +1,146 @@
+/**
+ * Template for creating new AI platform providers
+ *
+ * To create a new provider:
+ * 1. Copy this directory to src/providers/yourplatform/
+ * 2. Rename the class and implement all methods
+ * 3. Add provider name to types/index.ts ProviderName type
+ * 4. Register in src/providers/index.ts
+ * 5. Create documentation in docs/providers/yourplatform.md
+ */
+import { BaseProvider } from '../base';
+import { AuthenticationError, NotFoundError } from '../../types/provider';
+export class TemplateProvider extends BaseProvider {
+    name = 'grok'; // Change to your provider name (must match ProviderName type)
+    displayName = 'Template Provider'; // Human-readable name
+    supportedAuthMethods = ['api-key', 'cookies']; // Supported auth methods
+    /**
+     * Authenticate with the provider
+     */
+    async authenticate(config) {
+        this.config = config;
+        // Example: API key authentication
+        if (config.authMethod === 'api-key') {
+            if (!config.apiKey) {
+                throw new AuthenticationError('API key is required');
+            }
+            this.initClient('https://api.yourplatform.com', {
+                Authorization: `Bearer ${config.apiKey}`,
+            });
+            // Test authentication
+            await this.client.get('/auth/verify');
+            return true;
+        }
+        // Example: Cookie authentication
+        if (config.authMethod === 'cookies') {
+            if (!config.cookies) {
+                throw new AuthenticationError('Cookies are required');
+            }
+            const cookieString = Object.entries(config.cookies)
+                .map(([key, value]) => `${key}=${value}`)
+                .join('; ');
+            this.initClient('https://yourplatform.com', {
+                Cookie: cookieString,
+            });
+            return this.isAuthenticated();
+        }
+        throw new AuthenticationError(`Unsupported auth method: ${config.authMethod}`);
+    }
+    /**
+     * Check if currently authenticated
+     */
+    async isAuthenticated() {
+        this.requireAuth();
+        try {
+            // Make a test request to verify authentication
+            await this.client.get('/api/user/me');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * List all conversations
+     */
+    async listConversations(options) {
+        this.requireAuth();
+        const params = {
+            limit: options?.limit || 100,
+            offset: options?.offset || 0,
+        };
+        if (options?.since) {
+            params.since = options.since.toISOString();
+        }
+        if (options?.until) {
+            params.until = options.until.toISOString();
+        }
+        try {
+            const response = await this.client.get('/api/conversations', { params });
+            // Transform API response to ConversationSummary format
+            return response.data.conversations.map((conv) => ({
+                id: conv.id,
+                title: conv.title || 'Untitled',
+                messageCount: conv.message_count,
+                createdAt: new Date(conv.created_at),
+                updatedAt: new Date(conv.updated_at),
+                hasMedia: conv.has_media || false,
+                preview: conv.preview_text,
+            }));
+        }
+        catch (error) {
+            if (error.response?.status === 401) {
+                throw new AuthenticationError('Session expired');
+            }
+            throw error;
+        }
+    }
+    /**
+     * Fetch complete conversation with all messages
+     */
+    async fetchConversation(id) {
+        this.requireAuth();
+        try {
+            const response = await this.client.get(`/api/conversations/${id}`);
+            const data = response.data;
+            // Transform API response to Conversation format
+            return {
+                id: data.id,
+                provider: this.name,
+                title: data.title || 'Untitled',
+                messages: data.messages.map((msg) => ({
+                    id: msg.id,
+                    role: msg.role,
+                    content: msg.content,
+                    timestamp: new Date(msg.timestamp),
+                    metadata: msg.metadata || {},
+                    attachments: msg.attachments?.map((att) => ({
+                        id: att.id,
+                        type: att.type,
+                        url: att.url,
+                        mimeType: att.mime_type,
+                        size: att.size,
+                    })),
+                })),
+                createdAt: new Date(data.created_at),
+                updatedAt: new Date(data.updated_at),
+                metadata: {
+                    messageCount: data.messages.length,
+                    characterCount: data.messages.reduce((sum, m) => sum + m.content.length, 0),
+                    mediaCount: data.messages.reduce((sum, m) => sum + (m.attachments?.length || 0), 0),
+                    ...data.metadata,
+                },
+            };
+        }
+        catch (error) {
+            if (error.response?.status === 404) {
+                throw new NotFoundError(`Conversation ${id} not found`);
+            }
+            if (error.response?.status === 401) {
+                throw new AuthenticationError('Session expired');
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/_template/index.js.map

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

package/dist/providers/base.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Abstract base provider class with shared functionality
+ */
+import type { Provider, ListConversationsOptions, ConversationSummary, MediaDownloadResult } from '../types/provider';
+import type { ProviderName, ProviderConfig, Conversation } from '../types';
+import { AxiosInstance } from 'axios';
+export declare abstract class BaseProvider implements Provider {
+    abstract readonly name: ProviderName;
+    abstract readonly displayName: string;
+    abstract readonly supportedAuthMethods: ('api-key' | 'cookies' | 'oauth')[];
+    protected config?: ProviderConfig;
+    protected client?: AxiosInstance;
+    /**
+     * Initialize HTTP client with authentication
+     */
+    protected initClient(baseURL: string, headers?: Record<string, string>): void;
+    abstract authenticate(config: ProviderConfig): Promise<boolean>;
+    abstract isAuthenticated(): Promise<boolean>;
+    abstract listConversations(options?: ListConversationsOptions): Promise<ConversationSummary[]>;
+    abstract fetchConversation(id: string): Promise<Conversation>;
+    /**
+     * Default implementation for downloading media files
+     */
+    downloadMedia(url: string, outputPath: string): Promise<MediaDownloadResult>;
+    /**
+     * Helper to check if authentication is configured
+     */
+    protected requireAuth(): void;
+    /**
+     * Helper for exponential backoff retry
+     */
+    protected retry<T>(fn: () => Promise<T>, maxRetries?: number, baseDelay?: number): Promise<T>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAM7C,8BAAsB,YAAa,YAAW,QAAQ;IACpD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;IAE5E,SAAS,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IAClC,SAAS,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI;IAWjF,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAC/D,QAAQ,CAAC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAC9F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAE7D;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuClF;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,IAAI;IAM7B;;OAEG;cACa,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,SAAI,EAAE,SAAS,SAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAuB7F"}