History API

{
  "metadata": {
    "timestamp": "2025-01-15T12:00:00Z",
    "count": 5,
    "total": 5
  },
  "result": [
    {
      "id": 123,
      "userId": 456,
      "action": "status_changed",
      "changes": {
        "status": {
          "from": "active",
          "to": "inactive"
        }
      },
      "createdAt": "2025-01-15T10:45:00Z",
      "updatedAt": "2025-01-15T10:45:00Z"
    },
    {
      "id": 122,
      "userId": 456,
      "action": "events_updated",
      "changes": {
        "events": {
          "added": ["workorder.status.approved"],
          "removed": ["workorder.status.draft"]
        }
      },
      "createdAt": "2025-01-15T09:30:00Z",
      "updatedAt": "2025-01-15T09:30:00Z"
    },
    {
      "id": 121,
      "userId": 456,
      "action": "url_changed",
      "changes": {
        "url": {
          "from": "https://old-endpoint.com/webhook",
          "to": "https://new-endpoint.com/webhooks"
        }
      },
      "createdAt": "2025-01-14T15:20:00Z",
      "updatedAt": "2025-01-14T15:20:00Z"
    },
    {
      "id": 120,
      "userId": 456,
      "action": "webhook_created",
      "changes": {
        "url": "https://new-endpoint.com/webhooks",
        "events": ["workorder.status.published", "workorder.status.draft"],
        "status": "active"
      },
      "createdAt": "2025-01-14T15:00:00Z",
      "updatedAt": "2025-01-14T15:00:00Z"
    }
  ]
}

class WebhookAudit {
  constructor(accessToken) {
    this.accessToken = accessToken;
    this.baseUrl = 'https://api-sandbox.fndev.net';
  }

  async getHistory(webhookId, filters = {}) {
    const params = new URLSearchParams(filters);
    const response = await fetch(
      `${this.baseUrl}/api/v1/webhooks/${webhookId}/history?${params}`,
      {
        headers: { 'Authorization': `Bearer ${this.accessToken}` }
      }
    );
    return await response.json();
  }

  async getChangesByUser(webhookId, userId) {
    return await this.getHistory(webhookId, { userId });
  }

  async getRecentChanges(webhookId, hours = 24) {
    const history = await this.getHistory(webhookId, {
      sortBy: 'createdAt',
      sortDirection: 'DESC'
    });

    const since = new Date(Date.now() - hours * 60 * 60 * 1000);

    return history.result.filter(record =>
      new Date(record.createdAt) >= since
    );
  }

  async generateAuditReport(webhookId) {
    const history = await this.getHistory(webhookId);

    const report = {
      webhookId,
      totalChanges: history.metadata.total,
      changes: history.result.map(record => ({
        timestamp: record.createdAt,
        user: record.userId,
        action: record.action,
        details: this.formatChanges(record.changes)
      }))
    };

    return report;
  }

  formatChanges(changes) {
    return Object.entries(changes).map(([key, value]) => {
      if (value.from && value.to) {
        return `${key}: ${value.from} → ${value.to}`;
      }
      if (value.added && value.removed) {
        return `${key}: +${value.added.length} -${value.removed.length}`;
      }
      return `${key}: ${JSON.stringify(value)}`;
    }).join(', ');
  }
}

// Usage
const audit = new WebhookAudit(accessToken);

// Get full history
const history = await audit.getHistory('wh_abc123');

// Get changes by specific user
const userChanges = await audit.getChangesByUser('wh_abc123', 456);

// Get recent changes
const recent = await audit.getRecentChanges('wh_abc123', 24);

// Generate audit report
const report = await audit.generateAuditReport('wh_abc123');
console.log(`Webhook has ${report.totalChanges} changes`);
report.changes.forEach(change => {
  console.log(`  ${change.timestamp} - ${change.action} by user ${change.user}`);
});