@nathanvale/chatline 0.0.1

package/dist/config/generator.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Config File Generator for iMessage Timeline
+ *
+ * Implements CONFIG--T03: Add Config Generation Command
+ * Generates starter configuration files with documentation comments
+ */
+import type { ConfigFormat } from './schema.js';
+/**
+ * CONFIG-T03-AC02: Generate config file content in specified format
+ *
+ * @param format - Output format ('json' or 'yaml')
+ * @returns Formatted config file content as string
+ *
+ * @example
+ * ```typescript
+ * const yamlContent = generateConfigContent('yaml')
+ * const jsonContent = generateConfigContent('json')
+ * ```
+ */
+export declare function generateConfigContent(format: ConfigFormat): string;
+/**
+ * CONFIG-T03-AC04: Check if config file exists at path
+ *
+ * @param filePath - Path to check
+ * @returns True if file exists and is readable
+ */
+export declare function configFileExists(filePath: string): Promise<boolean>;
+/**
+ * CONFIG-T03-AC05: Validate generated config content
+ *
+ * Parses the generated content and validates against schema
+ * to ensure the template produces valid config.
+ *
+ * @param content - Generated config content
+ * @param format - Format of content ('json' | 'yaml')
+ * @returns Validation result
+ */
+export declare function validateGeneratedConfig(content: string, format: ConfigFormat): {
+    valid: boolean;
+    errors?: string[];
+};
+/**
+ * CONFIG-T03-AC01: Generate config file at specified path
+ *
+ * Implements the core config generation logic with:
+ * - Format selection (YAML/JSON)
+ * - Overwrite protection
+ * - Content validation
+ *
+ * @param options - Generation options
+ * @param options.filePath - Output file path
+ * @param options.format - File format ('json' | 'yaml')
+ * @param options.force - Overwrite existing file without prompt
+ * @returns Success/failure result
+ *
+ * @example
+ * ```typescript
+ * // Generate YAML config (default)
+ * await generateConfigFile({ filePath: './imessage-config.yaml' })
+ *
+ * // Generate JSON config
+ * await generateConfigFile({
+ *   filePath: './imessage-config.json',
+ *   format: 'json'
+ * })
+ *
+ * // Force overwrite
+ * await generateConfigFile({
+ *   filePath: './imessage-config.yaml',
+ *   force: true
+ * })
+ * ```
+ */
+export declare function generateConfigFile(options: {
+    filePath: string;
+    format?: ConfigFormat;
+    force?: boolean;
+}): Promise<{
+    success: boolean;
+    message: string;
+    filePath: string;
+}>;
+/**
+ * Get default config file path for a given format
+ *
+ * @param format - Desired format ('json' | 'yaml')
+ * @returns Default file path
+ */
+export declare function getDefaultConfigPath(format: ConfigFormat): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/config/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/config/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AA+K/C;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAOlE;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,GAClB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA4BvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,KAAK,CAAC,EAAE,OAAO,CAAA;CACf,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAkCnE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEjE"}

package/dist/config/generator.js

@@ -0,0 +1,320 @@
+/**
+ * Config File Generator for iMessage Timeline
+ *
+ * Implements CONFIG--T03: Add Config Generation Command
+ * Generates starter configuration files with documentation comments
+ */
+import { constants } from 'node:fs';
+import { access, writeFile } from 'node:fs/promises';
+import yaml from 'js-yaml';
+import { validateConfig } from './schema.js';
+/**
+ * CONFIG-T03-AC03: Config template with inline documentation
+ *
+ * This template includes comments explaining each configuration option.
+ * The comments are YAML-compatible and will be preserved in YAML output.
+ */
+const CONFIG_TEMPLATE_WITH_DOCS = `# iMessage Timeline Configuration File
+# Generated by: imessage-timeline init
+#
+# This file configures the iMessage message export and enrichment pipeline.
+# Supports both YAML and JSON formats with environment variable substitution.
+
+# Schema version (for future migrations)
+version: "1.0"
+
+# ============================================================================
+# Attachment Resolution
+# ============================================================================
+
+# Directories to search for message attachments
+# Multiple paths supported; first match wins
+# Environment variable expansion supported: \${HOME}/Library/Messages
+attachmentRoots:
+  - "~/Library/Messages/Attachments"
+  # Add additional search paths if needed:
+  # - "/path/to/imazing/backup/attachments"
+
+# ============================================================================
+# Gemini AI Configuration
+# ============================================================================
+
+gemini:
+  # Google Gemini API key (required for AI enrichment)
+  # Get your key from: https://makersuite.google.com/app/apikey
+  # Environment variable recommended for security: \${GEMINI_API_KEY}
+  apiKey: "\${GEMINI_API_KEY}"
+
+  # Gemini model to use for enrichment
+  # Options: gemini-1.5-pro, gemini-1.5-flash
+  # Default: gemini-1.5-pro (more accurate, slower)
+  model: "gemini-1.5-pro"
+
+  # Delay between API calls (milliseconds)
+  # Prevents rate limiting; adjust based on your quota
+  # Free tier: 60 requests/minute = 1000ms delay minimum
+  # Default: 1000 (1 second)
+  rateLimitDelay: 1000
+
+  # Maximum retries for failed API calls
+  # Applies exponential backoff with jitter
+  # Range: 0-10
+  # Default: 3
+  maxRetries: 3
+
+# ============================================================================
+# Firecrawl Configuration (Optional)
+# ============================================================================
+
+# firecrawl:
+#   # Firecrawl API key for enhanced link scraping (optional)
+#   # Get your key from: https://firecrawl.dev
+#   # Falls back to built-in scrapers if not provided
+#   apiKey: "\${FIRECRAWL_API_KEY}"
+#
+#   # Enable/disable Firecrawl for link enrichment
+#   # Default: true (if apiKey provided)
+#   enabled: true
+
+# ============================================================================
+# Enrichment Pipeline Configuration
+# ============================================================================
+
+enrichment:
+  # Enable image analysis (captions, descriptions via Gemini Vision)
+  # HEIC/TIFF files converted to JPG for analysis
+  # Default: true
+  enableVisionAnalysis: true
+
+  # Enable audio transcription (voice memos, audio messages)
+  # Includes timestamps, speaker detection, and summaries
+  # Default: true
+  enableAudioTranscription: true
+
+  # Enable link context extraction (titles, summaries, metadata)
+  # Uses Firecrawl if configured, falls back to built-in scrapers
+  # Default: true
+  enableLinkEnrichment: true
+
+  # Cache directory for image previews (HEIC/TIFF → JPG)
+  # Prevents redundant conversions on re-runs
+  # Default: ./.cache/images
+  imageCacheDir: "./.cache/images"
+
+  # Checkpoint interval (messages per checkpoint)
+  # Lower = more frequent checkpoints = safer but slower
+  # Higher = faster but more work lost on interruption
+  # Range: 1-10000
+  # Default: 100
+  checkpointInterval: 100
+
+  # Force refresh of existing enrichments
+  # If true, re-enriches messages even if already enriched
+  # Default: false (skip already-enriched messages)
+  forceRefresh: false
+
+# ============================================================================
+# Markdown Rendering Configuration
+# ============================================================================
+
+render:
+  # Group messages by time-of-day (Morning, Afternoon, Evening)
+  # If false, renders as flat chronological list
+  # Default: true
+  groupByTimeOfDay: true
+
+  # Render replies as nested blockquotes under parent message
+  # If false, renders as flat list with reply indicators
+  # Default: true
+  renderRepliesAsNested: true
+
+  # Render tapbacks (reactions) as emoji (❤️, 😂, etc.)
+  # If false, renders as text descriptions
+  # Default: true
+  renderTapbacksAsEmoji: true
+
+  # Maximum nesting depth for nested replies
+  # Prevents infinite recursion in circular reply chains
+  # Range: 1-100
+  # Default: 10
+  maxNestingDepth: 10
+`;
+/**
+ * CONFIG-T03-AC03: Generate JSON template with comments
+ *
+ * JSON doesn't support inline comments, so we use a separate
+ * structure with documentation as values.
+ */
+const CONFIG_TEMPLATE_JSON = {
+    _comment: 'iMessage Timeline Configuration File',
+    _generated: 'Generated by: imessage-timeline init',
+    _docs: 'Full documentation: https://github.com/your-repo/imessage-timeline',
+    version: '1.0',
+    attachmentRoots: ['~/Library/Messages/Attachments'],
+    gemini: {
+        _comment: 'Get API key from: https://makersuite.google.com/app/apikey',
+        apiKey: '${GEMINI_API_KEY}',
+        model: 'gemini-1.5-pro',
+        rateLimitDelay: 1000,
+        maxRetries: 3,
+    },
+    enrichment: {
+        enableVisionAnalysis: true,
+        enableAudioTranscription: true,
+        enableLinkEnrichment: true,
+        imageCacheDir: './.cache/images',
+        checkpointInterval: 100,
+        forceRefresh: false,
+    },
+    render: {
+        groupByTimeOfDay: true,
+        renderRepliesAsNested: true,
+        renderTapbacksAsEmoji: true,
+        maxNestingDepth: 10,
+    },
+};
+/**
+ * CONFIG-T03-AC02: Generate config file content in specified format
+ *
+ * @param format - Output format ('json' or 'yaml')
+ * @returns Formatted config file content as string
+ *
+ * @example
+ * ```typescript
+ * const yamlContent = generateConfigContent('yaml')
+ * const jsonContent = generateConfigContent('json')
+ * ```
+ */
+export function generateConfigContent(format) {
+    if (format === 'yaml') {
+        // Return YAML template with comments preserved
+        return CONFIG_TEMPLATE_WITH_DOCS;
+    }
+    // Return formatted JSON with indentation
+    return `${JSON.stringify(CONFIG_TEMPLATE_JSON, null, 2)}\n`;
+}
+/**
+ * CONFIG-T03-AC04: Check if config file exists at path
+ *
+ * @param filePath - Path to check
+ * @returns True if file exists and is readable
+ */
+export async function configFileExists(filePath) {
+    try {
+        await access(filePath, constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * CONFIG-T03-AC05: Validate generated config content
+ *
+ * Parses the generated content and validates against schema
+ * to ensure the template produces valid config.
+ *
+ * @param content - Generated config content
+ * @param format - Format of content ('json' | 'yaml')
+ * @returns Validation result
+ */
+export function validateGeneratedConfig(content, format) {
+    try {
+        let parsed;
+        if (format === 'json') {
+            parsed = JSON.parse(content);
+        }
+        else {
+            parsed = yaml.load(content);
+        }
+        // Validate against schema (will throw if invalid)
+        // Note: This will fail validation because ${GEMINI_API_KEY} is a placeholder
+        // In production, we document this expected behavior
+        validateConfig(parsed);
+        return { valid: true };
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            return {
+                valid: false,
+                errors: [error.message],
+            };
+        }
+        return {
+            valid: false,
+            errors: ['Unknown validation error'],
+        };
+    }
+}
+/**
+ * CONFIG-T03-AC01: Generate config file at specified path
+ *
+ * Implements the core config generation logic with:
+ * - Format selection (YAML/JSON)
+ * - Overwrite protection
+ * - Content validation
+ *
+ * @param options - Generation options
+ * @param options.filePath - Output file path
+ * @param options.format - File format ('json' | 'yaml')
+ * @param options.force - Overwrite existing file without prompt
+ * @returns Success/failure result
+ *
+ * @example
+ * ```typescript
+ * // Generate YAML config (default)
+ * await generateConfigFile({ filePath: './imessage-config.yaml' })
+ *
+ * // Generate JSON config
+ * await generateConfigFile({
+ *   filePath: './imessage-config.json',
+ *   format: 'json'
+ * })
+ *
+ * // Force overwrite
+ * await generateConfigFile({
+ *   filePath: './imessage-config.yaml',
+ *   force: true
+ * })
+ * ```
+ */
+export async function generateConfigFile(options) {
+    const { filePath, format = 'yaml', force = false } = options;
+    // CONFIG-T03-AC04: Check for existing file
+    const exists = await configFileExists(filePath);
+    if (exists && !force) {
+        return {
+            success: false,
+            message: `Config file already exists at ${filePath}. Use --force to overwrite.`,
+            filePath,
+        };
+    }
+    // CONFIG-T03-AC02 & AC03: Generate content with docs
+    const content = generateConfigContent(format);
+    // Write file
+    try {
+        await writeFile(filePath, content, 'utf-8');
+        return {
+            success: true,
+            message: `✅ Generated ${format.toUpperCase()} config at ${filePath}`,
+            filePath,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Failed to write config file: ${error instanceof Error ? error.message : String(error)}`,
+            filePath,
+        };
+    }
+}
+/**
+ * Get default config file path for a given format
+ *
+ * @param format - Desired format ('json' | 'yaml')
+ * @returns Default file path
+ */
+export function getDefaultConfigPath(format) {
+    return format === 'yaml' ? './imessage-config.yaml' : './imessage-config.json';
+}
+//# sourceMappingURL=generator.js.map

package/dist/config/generator.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Configuration Loader for iMessage Timeline
+ *
+ * Implements CONFIG--T02: Implement Config Loader
+ * Loads config from YAML/JSON files with env var substitution and precedence
+ */
+import { type Config } from './schema.js';
+/**
+ * CONFIG-T02-AC01: Discover config file in directory
+ *
+ * Checks files in order:
+ * 1. imessage-config.yaml
+ * 2. imessage-config.yml
+ * 3. imessage-config.json
+ *
+ * @param baseDir - Directory to search in (defaults to current directory)
+ * @returns Path to first existing config file, or null if none found
+ */
+export declare function discoverConfigFile(baseDir?: string): Promise<string | null>;
+/**
+ * CONFIG-T02-AC01: Load and parse config file
+ *
+ * Supports JSON and YAML formats with auto-detection
+ *
+ * @param filePath - Path to config file
+ * @returns Parsed config object (unvalidated)
+ * @throws Error if file cannot be read or parsed
+ */
+export declare function loadConfigFile(filePath: string): Promise<unknown>;
+/**
+ * CONFIG-T02-AC03: Substitute environment variables in config
+ *
+ * Recursively replaces ${VAR_NAME} patterns with environment variable values
+ *
+ * @param obj - Config object (or primitive)
+ * @returns Object with env vars substituted
+ *
+ * @example
+ * ```typescript
+ * // With process.env.GEMINI_API_KEY = 'secret123'
+ * substituteEnvVars({ apiKey: '${GEMINI_API_KEY}' })
+ * // => { apiKey: 'secret123' }
+ * ```
+ */
+export declare function substituteEnvVars(obj: unknown): unknown;
+/**
+ * CONFIG-T02-AC02: Merge configuration with precedence
+ *
+ * Precedence (highest to lowest):
+ * 1. CLI options
+ * 2. Config file
+ * 3. Defaults (applied by Zod schema)
+ *
+ * @param fileConfig - Config loaded from file
+ * @param cliOptions - Options from CLI flags
+ * @returns Merged config object
+ */
+export declare function mergeConfig(fileConfig: Partial<Config>, cliOptions?: Partial<Config>): Partial<Config>;
+/**
+ * CONFIG-T02: Main config loading function
+ *
+ * Loads configuration with the following precedence:
+ * 1. CLI options (highest priority)
+ * 2. Config file
+ * 3. Defaults from schema (lowest priority)
+ *
+ * @param options - Loading options
+ * @param options.configPath - Explicit config file path (optional)
+ * @param options.cliOptions - CLI options to merge (optional)
+ * @param options.skipCache - Force reload even if cached (optional)
+ * @returns Validated and merged configuration
+ * @throws Error if config is invalid or cannot be loaded
+ *
+ * @example
+ * ```typescript
+ * // Load with auto-discovery
+ * const config = await loadConfig()
+ *
+ * // Load specific file
+ * const config = await loadConfig({ configPath: './custom-config.yaml' })
+ *
+ * // Override with CLI options
+ * const config = await loadConfig({
+ *   cliOptions: {
+ *     gemini: { apiKey: 'override-key' }
+ *   }
+ * })
+ * ```
+ */
+export declare function loadConfig(options?: {
+    configPath?: string;
+    cliOptions?: Partial<Config>;
+    skipCache?: boolean;
+}): Promise<Config>;
+/**
+ * Clear the config cache
+ *
+ * Useful for testing or when config needs to be reloaded
+ */
+export declare function clearConfigCache(): void;
+/**
+ * Check if a config is currently cached
+ *
+ * @returns True if config is cached
+ */
+export declare function isConfigCached(): boolean;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,KAAK,MAAM,EAAsC,MAAM,aAAa,CAAA;AAS7E;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,GAAE,MAAsB,GAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA+BvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAC1B,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,EAC3B,UAAU,GAAE,OAAO,CAAC,MAAM,CAAM,GAC9B,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,UAAU,CAC/B,OAAO,GAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAA;CACd,GACJ,OAAO,CAAC,MAAM,CAAC,CA+CjB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC"}