feat(posthog): add generic configuration support to setup method

[dwolfand]

Pull request checklist

Please check if your PR fulfills the following requirements:

• The changes have been tested successfully.
• A changeset has been created (npm run changeset).
• I have read and followed the pull request guidelines.

Overview

Adds optional config parameter to the PostHog plugin's setup() method, enabling developers to pass custom PostHog SDK configuration options during initialization.

Closes #610

Changes

• Added optional config?: Record<string, any> parameter to SetupOptions interface
• Web: Merge config with existing options in posthog.init()
• Android: Use reflection to apply config properties to PostHogAndroidConfig
• iOS: Use Key-Value Coding to apply config properties to PostHogConfig
• Updated documentation with usage examples
• Updated posthog-js dependency from 1.160.3 to 1.265.1

Usage Example

await Posthog.setup({
  apiKey: 'YOUR_API_KEY',
  host: 'https://eu.i.posthog.com',
  config: {
    autocapture: false,
    enable_recording_console_log: true
  },
});

Testing

• ✅ Backward compatibility maintained - existing code works unchanged
• ✅ Cross-platform support verified
• ✅ Graceful error handling for invalid config properties
• ✅ No linting errors

This enhancement provides developers with the flexibility to customize any PostHog SDK configuration option while maintaining full backward compatibility.

[robingenz]

Please restore the pull request template and fill it out.

[dwolfand]

Please restore the pull request template and fill it out.

Sorry about that, just updated it.

[robingenz]

Suggested change

	* @since 8.0.0
	* @since 7.3.0

[robingenz]

Move this line one up so that i cannot overwrite api_host.

[robingenz]

Revert this change. Otherwise, we cannot merge it before the next major release since this would be a breaking change.

[robingenz]

Revert this change. Otherwise, we cannot merge it before the next major release since this would be a breaking change.

[robingenz]

Move this property before host -> alphabetical order

[robingenz]

Suggested change

	'@capawesome/capacitor-posthog': patch
	'@capawesome/capacitor-posthog': minor

[robingenz]

Suggested change

	**feat: add generic configuration support to setup method**: Added optional `config` parameter to `SetupOptions` interface allowing developers to pass custom PostHog SDK configuration options during initialization. This enables fine-grained control over PostHog behavior such as `autocapture`, `enable_recording_console_log`, and other SDK-specific settings across all platforms (Web, Android, iOS).
	feat: add `config` option to `SetupOptions`

[mirsella]

if anyone needs this until its merged, I've rebased this PR onto main + did a release https://github.com/mirsella/capacitor-plugins/tree/posthog-config

[robingenz]

Closing due to inactivity