talknote_rb 0.1.0 → 0.2.0

data/examples/complete_csv_export_example.rb

@@ -0,0 +1,268 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Example: Export all Talknote conversations (DMs and Groups) to separate CSV files
+require_relative '../lib/talknote'
+require 'csv'
+require 'time'
+require 'fileutils'
+
+def safe_get(hash, key, default = '')
+  return default if hash.nil?
+  hash[key] || default
+end
+
+def format_timestamp(timestamp)
+  return '' if timestamp.nil? || timestamp.empty?
+  Time.parse(timestamp).strftime('%Y-%m-%d %H:%M:%S')
+rescue
+  timestamp
+end
+
+def export_all_to_csv(output_dir = "talknote_export_#{Time.now.strftime('%Y%m%d_%H%M%S')}")
+  puts "🚀 Talknote Complete CSV Export"
+  puts "=" * 50
+  puts "⚠️  注意: Export処理は高負荷処理のため、大量のデータがある場合や"
+  puts "    サーバー側の負荷制限により処理が中断される可能性があります。"
+  puts "    処理が止まった場合は、時間をおいて再実行してください。"
+  puts
+  puts "Exporting all conversations to directory: #{output_dir}"
+  puts
+
+  # Create output directory
+  FileUtils.mkdir_p(output_dir)
+
+  begin
+    client = Talknote::Client.new
+    puts "✅ Successfully initialized Talknote client"
+  rescue StandardError => e
+    puts "❌ Failed to initialize client: #{e.message}"
+    puts "\nMake sure you've run: talknote init -i CLIENT_ID -s CLIENT_SECRET"
+    exit 1
+  end
+
+  total_conversations = 0
+  total_messages = 0
+
+  # Export DM conversations
+  puts "\n📱 Exporting DM conversations..."
+  dm_filename = File.join(output_dir, "dm_conversations.csv")
+
+  CSV.open(dm_filename, 'w', encoding: 'UTF-8') do |csv|
+    csv << [
+      'conversation_id',
+      'conversation_name',
+      'message_id',
+      'user_id',
+      'user_name',
+      'message',
+      'created_at',
+      'message_type'
+    ]
+
+    begin
+      dm_response = client.dm
+      dm_conversations = dm_response.dig('data', 'threads') || []
+      puts "Found #{dm_conversations.size} DM conversations"
+      total_conversations += dm_conversations.size
+
+      dm_conversations.each_with_index do |conversation, index|
+        conversation_id = safe_get(conversation, 'id')
+        conversation_name = safe_get(conversation, 'title')
+
+        print "  Processing DM #{index + 1}/#{dm_conversations.size}: #{conversation_name}"
+
+        # 注意: Export処理は高負荷がかかるため、API制限や負荷制限により処理が停止される可能性があります
+        # レート制限を回避するため、各会話処理間に適切な待機時間を設けています
+
+        begin
+          messages_response = client.dm_list(conversation_id)
+          messages = messages_response.dig('data', 'msg') || []
+          total_messages += messages.size
+
+          messages.each do |message|
+            csv << [
+              conversation_id,
+              conversation_name,
+              safe_get(message, 'id'),
+              safe_get(message, 'user_id'),
+              safe_get(message, 'user_name'),
+              safe_get(message, 'message'),
+              format_timestamp(safe_get(message, 'created_at')),
+              safe_get(message, 'type', 'text')
+            ]
+          end
+
+          puts " (#{messages.size} messages)"
+
+        rescue Talknote::Error => e
+          puts " ❌ Error: #{e.message}"
+          csv << [
+            conversation_id,
+            conversation_name,
+            '',
+            '',
+            '',
+            "ERROR: #{e.message}",
+            format_timestamp(Time.now.to_s),
+            'error'
+          ]
+        end
+
+        # レート制限対策: サーバーへの負荷を軽減するため、各会話処理後に待機時間を設ける
+        sleep(1)
+      end
+
+    rescue Talknote::Error => e
+      puts "❌ DM API Error: #{e.message}"
+    end
+  end
+
+  # Export Group conversations
+  puts "\n👥 Exporting group conversations..."
+  group_filename = File.join(output_dir, "group_conversations.csv")
+
+  CSV.open(group_filename, 'w', encoding: 'UTF-8') do |csv|
+    csv << [
+      'group_id',
+      'group_name',
+      'message_id',
+      'sender_id',
+      'sender_name',
+      'message',
+      'created_at',
+      'message_type',
+      'unread_count'
+    ]
+
+    begin
+      groups_response = client.group
+      groups = groups_response.dig('data', 'groups') || []
+      puts "Found #{groups.size} groups"
+      total_conversations += groups.size
+
+      groups.each_with_index do |group, index|
+        group_id = safe_get(group, 'id')
+        group_name = safe_get(group, 'name')
+
+        print "  Processing group #{index + 1}/#{groups.size}: #{group_name}"
+
+        # 注意: Export処理は高負荷がかかるため、API制限や負荷制限により処理が停止される可能性があります
+        # レート制限を回避するため、各グループ処理間に適切な待機時間を設けています
+
+        # Get unread count
+        unread_count = 0
+        begin
+          unread_response = client.group_unread(group_id)
+          unread_count = unread_response.dig('data', 'unread_count') || 0
+        rescue Talknote::Error
+          # Ignore unread count errors
+        end
+
+        begin
+          messages_response = client.group_list(group_id)
+          messages = messages_response.dig('data', 'messages') || []
+          total_messages += messages.size
+
+          messages.each do |message|
+            csv << [
+              group_id,
+              group_name,
+              safe_get(message, 'id'),
+              safe_get(message, 'sender_id'),
+              safe_get(message, 'sender_name'),
+              safe_get(message, 'message'),
+              format_timestamp(safe_get(message, 'created_at')),
+              safe_get(message, 'type', 'text'),
+              unread_count
+            ]
+          end
+
+          puts " (#{messages.size} messages, #{unread_count} unread)"
+
+        rescue Talknote::Error => e
+          puts " ❌ Error: #{e.message}"
+          csv << [
+            group_id,
+            group_name,
+            '',
+            '',
+            '',
+            "ERROR: #{e.message}",
+            format_timestamp(Time.now.to_s),
+            'error',
+            unread_count
+          ]
+        end
+
+        # レート制限対策: サーバーへの負荷を軽減するため、各グループ処理後に待機時間を設ける
+        sleep(1)
+      end
+
+    rescue Talknote::Error => e
+      puts "❌ Group API Error: #{e.message}"
+    end
+  end
+
+  # Create summary file
+  summary_filename = File.join(output_dir, "export_summary.txt")
+  File.write(summary_filename, <<~SUMMARY)
+    Talknote Export Summary
+    =======================
+    Export Date: #{Time.now.strftime('%Y-%m-%d %H:%M:%S')}
+
+    Files Created:
+    - dm_conversations.csv (Direct Messages)
+    - group_conversations.csv (Group Messages)
+    - export_summary.txt (This file)
+
+    Statistics:
+    - Total Conversations: #{total_conversations}
+    - Total Messages Exported: #{total_messages}
+
+    CSV Format:
+
+    DM Conversations:
+    - conversation_id: Unique identifier for the DM conversation
+    - conversation_name: Name of the conversation
+    - message_id: Unique identifier for the message
+    - sender_id: ID of the message sender
+    - sender_name: Name of the message sender
+    - message: The message content
+    - created_at: Timestamp when the message was created
+    - message_type: Type of message (text, image, etc.)
+
+    Group Conversations:
+    - group_id: Unique identifier for the group
+    - group_name: Name of the group
+    - message_id: Unique identifier for the message
+    - sender_id: ID of the message sender
+    - sender_name: Name of the message sender
+    - message: The message content
+    - created_at: Timestamp when the message was created
+    - message_type: Type of message (text, image, etc.)
+    - unread_count: Number of unread messages in the group
+  SUMMARY
+
+  puts
+  puts "🎉 Complete export finished!"
+  puts "📊 Total conversations: #{total_conversations}"
+  puts "📊 Total messages exported: #{total_messages}"
+  puts "📁 Files saved in directory: #{output_dir}"
+  puts
+  puts "Files created:"
+  puts "  - #{dm_filename}"
+  puts "  - #{group_filename}"
+  puts "  - #{summary_filename}"
+
+rescue StandardError => e
+  puts "💥 Unexpected error: #{e.message}"
+  puts e.backtrace.first(5).join("\n")
+  exit 1
+end
+
+if __FILE__ == $0
+  # Allow custom output directory as command line argument
+  output_dir = ARGV[0] || "talknote_export_#{Time.now.strftime('%Y%m%d_%H%M%S')}"
+  export_all_to_csv(output_dir)
+end

data/examples/dm_csv_export_example.rb

@@ -0,0 +1,133 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Example: Export all DM conversations to CSV
+require_relative '../lib/talknote'
+require 'csv'
+require 'time'
+
+def safe_get(hash, key, default = '')
+  return default if hash.nil?
+  hash[key] || default
+end
+
+def format_timestamp(timestamp)
+  return '' if timestamp.nil? || timestamp.empty?
+  Time.parse(timestamp).strftime('%Y-%m-%d %H:%M:%S')
+rescue
+  timestamp
+end
+
+def export_dm_to_csv(filename = "dm_export_#{Time.now.strftime('%Y%m%d_%H%M%S')}.csv")
+  puts "=== Talknote DM CSV Export ==="
+  puts "⚠️  注意: Export処理は高負荷処理のため、大量のデータがある場合や"
+  puts "    サーバー側の負荷制限により処理が中断される可能性があります。"
+  puts "    処理が止まった場合は、時間をおいて再実行してください。"
+  puts
+  puts "Exporting all DM conversations to: #{filename}"
+  puts
+
+  begin
+    client = Talknote::Client.new
+    puts "✅ Successfully initialized Talknote client"
+  rescue StandardError => e
+    puts "❌ Failed to initialize client: #{e.message}"
+    puts "\nMake sure you've run: talknote init -i CLIENT_ID -s CLIENT_SECRET"
+    exit 1
+  end
+
+  CSV.open(filename, 'w', encoding: 'UTF-8') do |csv|
+    # CSV header
+    csv << [
+      'conversation_id',
+      'conversation_name',
+      'message_id',
+      'user_id',
+      'user_name',
+      'message',
+      'created_at',
+      'message_type'
+    ]
+
+    begin
+      # Get all DM conversations
+      puts "📋 Getting all DM conversations..."
+      dm_response = client.dm
+      dm_conversations = dm_response.dig('data', 'threads') || []
+      puts "Found #{dm_conversations.size} DM conversations"
+
+      total_messages = 0
+
+      dm_conversations.each_with_index do |conversation, index|
+        conversation_id = safe_get(conversation, 'id')
+        conversation_name = safe_get(conversation, 'title')
+
+        puts "Processing conversation #{index + 1}/#{dm_conversations.size}: #{conversation_name} (ID: #{conversation_id})"
+
+        # 注意: Export処理は高負荷がかかるため、API制限や負荷制限により処理が停止される可能性があります
+        # レート制限を回避するため、各会話処理前に適切な待機時間を設けています
+
+        begin
+          # Get messages from this conversation
+          messages_response = client.dm_list(conversation_id)
+          messages = messages_response.dig('data', 'msg') || []
+
+          puts "  Found #{messages.size} messages"
+          total_messages += messages.size
+
+          messages.each do |message|
+            csv << [
+              conversation_id,
+              conversation_name,
+              safe_get(message, 'id'),
+              safe_get(message, 'user_id'),
+              safe_get(message, 'user_name'),
+              safe_get(message, 'message'),
+              format_timestamp(safe_get(message, 'created_at')),
+              safe_get(message, 'type', 'text')
+            ]
+          end
+
+        rescue Talknote::Error => e
+          puts "  ❌ Error getting messages for conversation #{conversation_id}: #{e.message}"
+          # Add error row to CSV
+          csv << [
+            conversation_id,
+            conversation_name,
+            '',
+            '',
+            '',
+            "ERROR: #{e.message}",
+            format_timestamp(Time.now.to_s),
+            'error'
+          ]
+        end
+
+        # レート制限対策: サーバーへの負荷を軽減するため、各会話処理後に待機時間を設ける
+        # 大量の会話がある場合やAPI制限が厳しい場合は、この値を調整してください
+        sleep(1)
+      end
+
+      puts
+      puts "🎉 Export completed successfully!"
+      puts "📊 Total conversations: #{dm_conversations.size}"
+      puts "📊 Total messages exported: #{total_messages}"
+      puts "📄 File saved as: #{filename}"
+
+    rescue Talknote::Error => e
+      puts "❌ API Error: #{e.message}"
+      exit 1
+    end
+  end
+
+rescue StandardError => e
+  puts "💥 Unexpected error: #{e.message}"
+  puts e.backtrace.first(5).join("\n")
+  exit 1
+end
+
+if __FILE__ == $0
+  # Allow custom filename as command line argument
+  filename = ARGV[0] || "dm_export_#{Time.now.strftime('%Y%m%d_%H%M%S')}.csv"
+  export_dm_to_csv(filename)
+end

data/examples/dm_example.rb

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Example usage of the Talknote DM API
+require_relative '../lib/talknote'
+
+begin
+  # Initialize the client
+  client = Talknote::Client.new
+
+  puts "=== Talknote DM API Example ==="
+  puts
+
+  # Get all DM conversations
+  puts "1. Getting all DM conversations..."
+  dm_response = client.dm
+  dm_conversations = dm_response.dig('data', 'threads') || []
+  puts "Found #{dm_conversations.size} DM conversations"
+  puts
+
+  if dm_conversations.any?
+    # Get the first conversation ID for examples
+    first_conversation = dm_conversations.first
+    conversation_id = first_conversation['id']
+
+    puts "2. Getting messages from conversation #{conversation_id}..."
+    messages = client.dm_list(conversation_id)
+    puts "Found #{messages.size} messages in this conversation"
+    puts
+
+    puts "3. Getting unread count for conversation #{conversation_id}..."
+    unread_count = client.dm_unread(conversation_id)
+    puts "Unread messages: #{unread_count}"
+    puts
+
+    # Example of sending a message (commented out to avoid spam)
+    # puts "4. Sending a test message..."
+    # result = client.dm_post(conversation_id, "Hello from Ruby client!")
+    # puts "Message sent: #{result}"
+    # puts
+  else
+    puts "No DM conversations found"
+  end
+
+rescue Talknote::Error => e
+  puts "Talknote API Error: #{e.message}"
+  exit 1
+rescue Errno::ENOENT => e
+  puts "Authentication token not found. Please run 'bundle exec talknote init' first."
+  exit 1
+rescue => e
+  puts "Unexpected error: #{e.message}"
+  puts e.backtrace.join("\n")
+  exit 1
+end

data/examples/group_csv_export_example.rb

@@ -0,0 +1,146 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Example: Export all group conversations to CSV
+require_relative '../lib/talknote'
+require 'csv'
+require 'time'
+
+def safe_get(hash, key, default = '')
+  return default if hash.nil?
+  hash[key] || default
+end
+
+def format_timestamp(timestamp)
+  return '' if timestamp.nil? || timestamp.empty?
+  Time.parse(timestamp).strftime('%Y-%m-%d %H:%M:%S')
+rescue
+  timestamp
+end
+
+def export_groups_to_csv(filename = "group_export_#{Time.now.strftime('%Y%m%d_%H%M%S')}.csv")
+  puts "=== Talknote Group CSV Export ==="
+  puts "⚠️  注意: Export処理は高負荷処理のため、大量のデータがある場合や"
+  puts "    サーバー側の負荷制限により処理が中断される可能性があります。"
+  puts "    処理が止まった場合は、時間をおいて再実行してください。"
+  puts
+  puts "Exporting all group conversations to: #{filename}"
+  puts
+
+  begin
+    client = Talknote::Client.new
+    puts "✅ Successfully initialized Talknote client"
+  rescue StandardError => e
+    puts "❌ Failed to initialize client: #{e.message}"
+    puts "\nMake sure you've run: talknote init -i CLIENT_ID -s CLIENT_SECRET"
+    exit 1
+  end
+
+  CSV.open(filename, 'w', encoding: 'UTF-8') do |csv|
+    # CSV header
+    csv << [
+      'group_id',
+      'group_name',
+      'message_id',
+      'sender_id',
+      'sender_name',
+      'message',
+      'created_at',
+      'message_type',
+      'unread_count'
+    ]
+
+    begin
+      # Get all groups
+      puts "📋 Getting all groups..."
+      groups_response = client.group
+      groups = groups_response.dig('data', 'groups') || []
+      puts "Found #{groups.size} groups"
+
+      total_messages = 0
+
+      groups.each_with_index do |group, index|
+        group_id = safe_get(group, 'id')
+        group_name = safe_get(group, 'name')
+
+        puts "Processing group #{index + 1}/#{groups.size}: #{group_name} (ID: #{group_id})"
+
+        # 注意: Export処理は高負荷がかかるため、API制限や負荷制限により処理が停止される可能性があります
+        # レート制限を回避するため、各グループ処理前に適切な待機時間を設けています
+
+        # Get unread count for this group
+        unread_count = 0
+        begin
+          unread_response = client.group_unread(group_id)
+          unread_count = unread_response.dig('data', 'unread_count') || 0
+          puts "  Unread messages: #{unread_count}"
+        rescue Talknote::Error => e
+          puts "  ❌ Could not get unread count: #{e.message}"
+        end
+
+        begin
+          # Get messages from this group
+          messages_response = client.group_list(group_id)
+          messages = messages_response.dig('data', 'messages') || []
+
+          puts "  Found #{messages.size} messages"
+          total_messages += messages.size
+
+          messages.each do |message|
+            csv << [
+              group_id,
+              group_name,
+              safe_get(message, 'id'),
+              safe_get(message, 'sender_id'),
+              safe_get(message, 'sender_name'),
+              safe_get(message, 'message'),
+              format_timestamp(safe_get(message, 'created_at')),
+              safe_get(message, 'type', 'text'),
+              unread_count
+            ]
+          end
+
+        rescue Talknote::Error => e
+          puts "  ❌ Error getting messages for group #{group_id}: #{e.message}"
+          # Add error row to CSV
+          csv << [
+            group_id,
+            group_name,
+            '',
+            '',
+            '',
+            "ERROR: #{e.message}",
+            format_timestamp(Time.now.to_s),
+            'error',
+            unread_count
+          ]
+        end
+
+        # レート制限対策: サーバーへの負荷を軽減するため、各グループ処理後に待機時間を設ける
+        # 大量のグループがある場合やAPI制限が厳しい場合は、この値を調整してください
+        sleep(1)
+      end
+
+      puts
+      puts "🎉 Export completed successfully!"
+      puts "📊 Total groups: #{groups.size}"
+      puts "📊 Total messages exported: #{total_messages}"
+      puts "📄 File saved as: #{filename}"
+
+    rescue Talknote::Error => e
+      puts "❌ API Error: #{e.message}"
+      exit 1
+    end
+  end
+
+rescue StandardError => e
+  puts "💥 Unexpected error: #{e.message}"
+  puts e.backtrace.first(5).join("\n")
+  exit 1
+end
+
+if __FILE__ == $0
+  # Allow custom filename as command line argument
+  filename = ARGV[0] || "group_export_#{Time.now.strftime('%Y%m%d_%H%M%S')}.csv"
+  export_groups_to_csv(filename)
+end