@alisaitteke/photoshop-mcp 1.7.2 → 1.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/AGENTS.md +2 -0
  2. package/README.de.md +3 -6
  3. package/README.es.md +3 -6
  4. package/README.ja.md +3 -6
  5. package/README.md +7 -9
  6. package/README.tr.md +3 -7
  7. package/README.zh-CN.md +3 -6
  8. package/dist/analytics/config.d.ts +0 -5
  9. package/dist/analytics/config.d.ts.map +1 -1
  10. package/dist/analytics/config.js +1 -22
  11. package/dist/analytics/config.js.map +1 -1
  12. package/dist/analytics/ga4-node.d.ts +20 -0
  13. package/dist/analytics/ga4-node.d.ts.map +1 -0
  14. package/dist/analytics/ga4-node.js +117 -0
  15. package/dist/analytics/ga4-node.js.map +1 -0
  16. package/dist/analytics/ga4-shared.d.ts +15 -0
  17. package/dist/analytics/ga4-shared.d.ts.map +1 -0
  18. package/dist/analytics/ga4-shared.js +119 -0
  19. package/dist/analytics/ga4-shared.js.map +1 -0
  20. package/dist/analytics/index.d.ts.map +1 -1
  21. package/dist/analytics/index.js +2 -15
  22. package/dist/analytics/index.js.map +1 -1
  23. package/dist/analytics/install-cohorts.d.ts +1 -1
  24. package/dist/analytics/install-cohorts.js +1 -1
  25. package/dist/analytics/milestones.d.ts +1 -1
  26. package/dist/analytics/milestones.js +1 -1
  27. package/dist/analytics/mixpanel-node.d.ts.map +1 -1
  28. package/dist/analytics/mixpanel-node.js +8 -1
  29. package/dist/analytics/mixpanel-node.js.map +1 -1
  30. package/dist/analytics/provider.d.ts.map +1 -1
  31. package/dist/analytics/provider.js +2 -8
  32. package/dist/analytics/provider.js.map +1 -1
  33. package/dist/analytics/types.d.ts +2 -2
  34. package/dist/analytics/types.d.ts.map +1 -1
  35. package/dist/api/extendscript.d.ts +98 -0
  36. package/dist/api/extendscript.d.ts.map +1 -1
  37. package/dist/api/extendscript.js +850 -0
  38. package/dist/api/extendscript.js.map +1 -1
  39. package/dist/core/server.d.ts.map +1 -1
  40. package/dist/core/server.js +2 -0
  41. package/dist/core/server.js.map +1 -1
  42. package/dist/errors/envelope.d.ts +1 -1
  43. package/dist/errors/envelope.d.ts.map +1 -1
  44. package/dist/errors/envelope.js +2 -0
  45. package/dist/errors/envelope.js.map +1 -1
  46. package/dist/prompts/instructions.d.ts.map +1 -1
  47. package/dist/prompts/instructions.js +6 -2
  48. package/dist/prompts/instructions.js.map +1 -1
  49. package/dist/prompts/templates/remove-background.js +3 -3
  50. package/dist/prompts/templates/remove-background.js.map +1 -1
  51. package/dist/tools/document-tools.d.ts.map +1 -1
  52. package/dist/tools/document-tools.js +142 -0
  53. package/dist/tools/document-tools.js.map +1 -1
  54. package/dist/tools/filter-tools.d.ts.map +1 -1
  55. package/dist/tools/filter-tools.js +138 -0
  56. package/dist/tools/filter-tools.js.map +1 -1
  57. package/dist/tools/mask-tools.d.ts.map +1 -1
  58. package/dist/tools/mask-tools.js +105 -1
  59. package/dist/tools/mask-tools.js.map +1 -1
  60. package/dist/tools/recipes/batch-mockup-replace.d.ts.map +1 -1
  61. package/dist/tools/recipes/batch-mockup-replace.js +7 -5
  62. package/dist/tools/recipes/batch-mockup-replace.js.map +1 -1
  63. package/dist/tools/selection-tools.d.ts.map +1 -1
  64. package/dist/tools/selection-tools.js +327 -0
  65. package/dist/tools/selection-tools.js.map +1 -1
  66. package/dist/tools/smart-object-tools.d.ts +4 -0
  67. package/dist/tools/smart-object-tools.d.ts.map +1 -0
  68. package/dist/tools/smart-object-tools.js +155 -0
  69. package/dist/tools/smart-object-tools.js.map +1 -0
  70. package/llms.txt +2 -2
  71. package/package.json +2 -3
  72. package/web/dist/assets/index-kSYkHU5s.js +258 -0
  73. package/web/dist/index.html +1 -1
  74. package/web/dist/assets/index-SNfxhJjr.js +0 -350
package/AGENTS.md CHANGED
@@ -14,6 +14,8 @@
14
14
 
15
15
  **Prerequisites:** Photoshop running on Windows or macOS, Node.js 18+. This is unofficial and not affiliated with Adobe.
16
16
 
17
+ **Tool surface:** 118 MCP tools — 102 atomic `photoshop_*` + 16 recipe `photoshop_recipe_*`; 23 MCP prompt templates (`ps.*`).
18
+
17
19
  ## Architecture (agent view)
18
20
 
19
21
  ```
package/README.de.md CHANGED
@@ -640,12 +640,9 @@ Zur Claude Desktop-Konfiguration hinzufügen (`~/Library/Application Support/Cla
640
640
  - `LOG_LEVEL`: Protokollierungsstufe (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)
641
641
  - `ANALYTICS_DISABLED`: Auf `1` oder `true` setzen, um anonyme Nutzungsanalysen vollständig zu deaktivieren
642
642
  - `POSTHOG_DISABLED`: Veralteter Alias für `ANALYTICS_DISABLED`
643
- - `ANALYTICS_PROVIDER`: Analytics-Backend — `mixpanel` (Standard) oder `posthog` (rollback)
644
- - `MIXPANEL_TOKEN`: (Optional) Mixpanel-Projekt-Token überschreiben
645
- - `MIXPANEL_API_HOST`: (Optional) Mixpanel-Ingest-Host (Standard: `https://api-eu.mixpanel.com`)
646
- - `POSTHOG_KEY`: (Optional, veraltet) PostHog-Projekt-Schlüssel — nur verwendet, wenn `ANALYTICS_PROVIDER=posthog`
647
- - `POSTHOG_API_HOST`: (Optional, veraltet) PostHog-Ingest-Host (Standard: `https://a.alisait.com`)
648
- - `POSTHOG_UI_HOST`: (Optional, veraltet) PostHog-UI-Host (Standard: `https://eu.posthog.com`)
643
+ - `POSTHOG_KEY`: (Optional) PostHog-Projekt-Schlüssel — Standard ist eingebettet; für Forks oder Staging überschreiben
644
+ - `POSTHOG_API_HOST`: (Optional) PostHog-Ingest-Host (Standard: `https://a.alisait.com`)
645
+ - `POSTHOG_UI_HOST`: (Optional) PostHog-UI-Host (Standard: `https://eu.posthog.com`)
649
646
 
650
647
  ## Verfügbare Werkzeuge
651
648
 
package/README.es.md CHANGED
@@ -595,12 +595,9 @@ Añada a su configuración de Claude Desktop (`~/Library/Application Support/Cla
595
595
  - `LOG_LEVEL`: Nivel de registro (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)
596
596
  - `ANALYTICS_DISABLED`: Establezca en `1` o `true` para deshabilitar completamente el análisis de uso anónimo
597
597
  - `POSTHOG_DISABLED`: Alias heredado de `ANALYTICS_DISABLED`
598
- - `ANALYTICS_PROVIDER`: Backend de análisis — `mixpanel` (predeterminado) o `posthog` (rollback)
599
- - `MIXPANEL_TOKEN`: (Opcional) Anule el token del proyecto Mixpanel
600
- - `MIXPANEL_API_HOST`: (Opcional) Host de ingesta de Mixpanel (predeterminado: `https://api-eu.mixpanel.com`)
601
- - `POSTHOG_KEY`: (Opcional, heredado) Clave del proyecto PostHog — se usa solo cuando `ANALYTICS_PROVIDER=posthog`
602
- - `POSTHOG_API_HOST`: (Opcional, heredado) Host de ingesta de PostHog (predeterminado: `https://a.alisait.com`)
603
- - `POSTHOG_UI_HOST`: (Opcional, heredado) Host de UI de PostHog (predeterminado: `https://eu.posthog.com`)
598
+ - `POSTHOG_KEY`: (Opcional) Clave del proyecto PostHog — hay una predeterminada integrada; anule para forks o staging
599
+ - `POSTHOG_API_HOST`: (Opcional) Host de ingesta de PostHog (predeterminado: `https://a.alisait.com`)
600
+ - `POSTHOG_UI_HOST`: (Opcional) Host de UI de PostHog (predeterminado: `https://eu.posthog.com`)
604
601
 
605
602
  ## Herramientas disponibles
606
603
 
package/README.ja.md CHANGED
@@ -597,12 +597,9 @@ Claude Desktopの設定に追加してください(macOSは`~/Library/Applicat
597
597
  - `LOG_LEVEL`:ログレベル(0=DEBUG、1=INFO、2=WARN、3=ERROR)
598
598
  - `ANALYTICS_DISABLED`:`1`または`true`に設定して匿名使用状況の解析を完全に無効化
599
599
  - `POSTHOG_DISABLED`:`ANALYTICS_DISABLED`の旧エイリアス
600
- - `ANALYTICS_PROVIDER`:解析バックエンド — `mixpanel`(デフォルト)または`posthog`(ロールバック)
601
- - `MIXPANEL_TOKEN`:(オプション)Mixpanelプロジェクトトークンを上書き
602
- - `MIXPANEL_API_HOST`:(オプション)Mixpanelインジェストホスト(デフォルト:`https://api-eu.mixpanel.com`)
603
- - `POSTHOG_KEY`:(オプション、旧仕様)PostHogプロジェクトキー — `ANALYTICS_PROVIDER=posthog`の場合のみ使用
604
- - `POSTHOG_API_HOST`:(オプション、旧仕様)PostHogインジェストホスト(デフォルト:`https://a.alisait.com`)
605
- - `POSTHOG_UI_HOST`:(オプション、旧仕様)PostHog UIホスト(デフォルト:`https://eu.posthog.com`)
600
+ - `POSTHOG_KEY`:(オプション)PostHogプロジェクトキー — デフォルトが組み込まれています。フォークやステージング用に上書き可能
601
+ - `POSTHOG_API_HOST`:(オプション)PostHogインジェストホスト(デフォルト:`https://a.alisait.com`)
602
+ - `POSTHOG_UI_HOST`:(オプション)PostHog UIホスト(デフォルト:`https://eu.posthog.com`)
606
603
 
607
604
  ## 利用可能なツール
608
605
 
package/README.md CHANGED
@@ -19,6 +19,7 @@
19
19
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
20
20
  [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS-lightgrey.svg)]()
21
21
  [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.alisaitteke%2Fphotoshop--mcp-purple.svg)](https://registry.modelcontextprotocol.io)
22
+ [![MCP Toplist](https://mcptoplist.com/badge/io.github.alisaitteke%2Fphotoshop-mcp.svg)](https://mcptoplist.com/server/io.github.alisaitteke%2Fphotoshop-mcp)
22
23
  [![Website](https://img.shields.io/badge/website-photoshop--mcp-cyan.svg)](https://alisaitteke.github.io/photoshop-mcp/)
23
24
 
24
25
  A Model Context Protocol (MCP) server that enables AI assistants like Claude and Cursor to control Adobe Photoshop programmatically. This allows you to create designs, manipulate images, and automate Photoshop workflows through natural language commands while working in your IDE — or through the bundled **standalone web UI**, which supports both API keys and CLI subscription accounts (Claude Code / Gemini CLI). The UI also offers an opt-in **Action Plan (beta)** mode that plans every Photoshop step in one LLM call, then runs them in a single pass.
@@ -181,7 +182,7 @@ requests into reliable Photoshop actions:
181
182
  grade, frequency separation, batch mockup, organize layers, gradient fade,
182
183
  sky blend, dodge & burn, remove distraction, split carousel, batch watermark,
183
184
  passport photo, csv to cards). Each wraps steps in a single
184
- Photoshop history state (one Undo reverts all). **102 tools total** (86 atomic
185
+ Photoshop history state (one Undo reverts all). **118 tools total** (102 atomic
185
186
  + 16 recipe).
186
187
  - **Generative AI** — `photoshop_generative_fill`, `photoshop_generative_remove`,
187
188
  `photoshop_generative_expand`, `photoshop_generative_upscale`, `photoshop_sky_replacement`,
@@ -598,7 +599,7 @@ Never guess — read get_state after a failure and propose the next single step.
598
599
  - **Supports Photoshop 2012-2025+**
599
600
  - **ExtendScript API**: Universal compatibility via AppleScript/COM automation
600
601
  - **Auto-Detection**: Automatically finds Photoshop installation on your system
601
- - **102 Tools**: 86 atomic `photoshop_*` + 16 recipe `photoshop_recipe_*`
602
+ - **118 Tools**: 102 atomic `photoshop_*` + 16 recipe `photoshop_recipe_*`
602
603
  - **AI/Prompt Layer**: 23 MCP prompt templates (16 recipe + 7 guide), server instructions, state/preview/capabilities tools
603
604
  - **Document Management**: Create, open, save, close, crop documents
604
605
  - **Layer Operations**: Create, delete, duplicate, merge, transform layers
@@ -606,7 +607,7 @@ Never guess — read get_state after a failure and propose the next single step.
606
607
  - **Layer Styles**: Drop shadow, outer glow, stroke, bevel & emboss
607
608
  - **Text Formatting**: Font, size, color, alignment controls
608
609
  - **Image Placement**: Place images, open files, fit to document
609
- - **Filters**: Gaussian Blur, Sharpen, Noise, Motion Blur
610
+ - **Filters**: Gaussian Blur, Sharpen, Noise, Motion Blur, High Pass, Smart Blur
610
611
  - **Color Adjustments**: Brightness/Contrast, Hue/Saturation, Curves, Auto Levels/Contrast
611
612
  - **Color Grading**: 3D LUT (Color Lookup) layers, Vibrance, Exposure, Photo Filter, Gradient Map
612
613
  - **Data-Driven Graphics**: CSV/variables XML → one image per row ("mail merge for images")
@@ -733,12 +734,9 @@ const q = query({
733
734
  - `LOG_LEVEL`: Logging level (0=DEBUG, 1=INFO, 2=WARN, 3=ERROR)
734
735
  - `ANALYTICS_DISABLED`: Set to `1` or `true` to disable anonymous usage analytics entirely
735
736
  - `POSTHOG_DISABLED`: Legacy alias for `ANALYTICS_DISABLED`
736
- - `ANALYTICS_PROVIDER`: Analytics backend — `mixpanel` (default) or `posthog` (rollback)
737
- - `MIXPANEL_TOKEN`: (Optional) Override the Mixpanel project token
738
- - `MIXPANEL_API_HOST`: (Optional) Mixpanel ingest host (default: `https://api-eu.mixpanel.com`)
739
- - `POSTHOG_KEY`: (Optional, legacy) PostHog project key — used only when `ANALYTICS_PROVIDER=posthog`
740
- - `POSTHOG_API_HOST`: (Optional, legacy) PostHog ingest host (default: `https://a.alisait.com`)
741
- - `POSTHOG_UI_HOST`: (Optional, legacy) PostHog UI host (default: `https://eu.posthog.com`)
737
+ - `POSTHOG_KEY`: (Optional) PostHog project key — a default is embedded; override for forks or staging
738
+ - `POSTHOG_API_HOST`: (Optional) PostHog ingest host (default: `https://a.alisait.com`)
739
+ - `POSTHOG_UI_HOST`: (Optional) PostHog UI host (default: `https://eu.posthog.com`)
742
740
 
743
741
  ## Available Tools
744
742
 
package/README.tr.md CHANGED
@@ -683,13 +683,9 @@ const q = query({
683
683
  - `ANALYTICS_DISABLED`: Anonim kullanım analizlerini tamamen devre dışı bırakmak için `1` veya `true`
684
684
  olarak ayarlayın
685
685
  - `POSTHOG_DISABLED`: `ANALYTICS_DISABLED` için eski takma ad
686
- - `ANALYTICS_PROVIDER`: Analiz arka ucu — `mixpanel` (varsayılan) veya `posthog` (geri alma)
687
- - `MIXPANEL_TOKEN`: (İsteğe bağlı) Mixpanel proje tokenını geçersiz kılın
688
- - `MIXPANEL_API_HOST`: (İsteğe bağlı) Mixpanel ingest host'u (varsayılan: `https://api-eu.mixpanel.com`)
689
- - `POSTHOG_KEY`: (İsteğe bağlı, eski) PostHog proje anahtarı — yalnızca `ANALYTICS_PROVIDER=posthog`
690
- olduğunda kullanılır
691
- - `POSTHOG_API_HOST`: (İsteğe bağlı, eski) PostHog ingest host'u (varsayılan: `https://a.alisait.com`)
692
- - `POSTHOG_UI_HOST`: (İsteğe bağlı, eski) PostHog UI host'u (varsayılan: `https://eu.posthog.com`)
686
+ - `POSTHOG_KEY`: (İsteğe bağlı) PostHog proje anahtarı — varsayılan gömülüdür; fork veya staging için geçersiz kılın
687
+ - `POSTHOG_API_HOST`: (İsteğe bağlı) PostHog ingest host'u (varsayılan: `https://a.alisait.com`)
688
+ - `POSTHOG_UI_HOST`: (İsteğe bağlı) PostHog UI host'u (varsayılan: `https://eu.posthog.com`)
693
689
 
694
690
  ## Mevcut Araçlar
695
691
 
package/README.zh-CN.md CHANGED
@@ -592,12 +592,9 @@ npx @alisaitteke/photoshop-mcp
592
592
  - `LOG_LEVEL`:日志级别(0=DEBUG,1=INFO,2=WARN,3=ERROR)
593
593
  - `ANALYTICS_DISABLED`:设置为 `1` 或 `true` 可完全禁用匿名使用分析
594
594
  - `POSTHOG_DISABLED`:`ANALYTICS_DISABLED` 的旧版别名
595
- - `ANALYTICS_PROVIDER`:分析后端 — `mixpanel`(默认)或 `posthog`(回滚)
596
- - `MIXPANEL_TOKEN`:(可选)覆盖 Mixpanel 项目令牌
597
- - `MIXPANEL_API_HOST`:(可选)Mixpanel 数据采集主机(默认:`https://api-eu.mixpanel.com`)
598
- - `POSTHOG_KEY`:(可选,旧版)PostHog 项目密钥 — 仅在 `ANALYTICS_PROVIDER=posthog` 时使用
599
- - `POSTHOG_API_HOST`:(可选,旧版)PostHog 数据采集主机(默认:`https://a.alisait.com`)
600
- - `POSTHOG_UI_HOST`:(可选,旧版)PostHog UI 主机(默认:`https://eu.posthog.com`)
595
+ - `POSTHOG_KEY`:(可选)PostHog 项目密钥 — 已内置默认值;可用于 fork 或预发布环境覆盖
596
+ - `POSTHOG_API_HOST`:(可选)PostHog 数据采集主机(默认:`https://a.alisait.com`)
597
+ - `POSTHOG_UI_HOST`:(可选)PostHog UI 主机(默认:`https://eu.posthog.com`)
601
598
 
602
599
  ## 可用工具
603
600
 
@@ -1,10 +1,5 @@
1
- export type AnalyticsProviderName = 'mixpanel' | 'posthog';
2
1
  export declare function isPostHogDisabledByEnv(): boolean;
3
2
  export declare function isAnalyticsDisabledByEnv(): boolean;
4
- export declare function resolveAnalyticsProvider(): AnalyticsProviderName;
5
- export declare function resolveMixpanelToken(): string;
6
- export declare function resolveMixpanelApiHost(): string;
7
- export declare function resolveMixpanelNodeHost(): string;
8
3
  export declare function resolvePostHogKey(): string;
9
4
  export declare function resolvePostHogApiHost(): string;
10
5
  export declare function resolvePostHogUiHost(): string;
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,SAAS,CAAC;AAO3D,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,CAIhE;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAKzC"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AASA,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}
@@ -1,9 +1,6 @@
1
1
  const DEFAULT_POSTHOG_KEY = 'phc_mejq4ZZ8jTNZPiusjh7vHyPzWYinzsDwVJW43SM5FEcg';
2
2
  const DEFAULT_API_HOST = 'https://a.alisait.com';
3
3
  const DEFAULT_UI_HOST = 'https://eu.posthog.com';
4
- const DEFAULT_MIXPANEL_TOKEN = 'b7df8a8fde7156da7b9c99ecbb7e9862';
5
- const DEFAULT_MIXPANEL_API_HOST = 'https://api-eu.mixpanel.com';
6
- const DEFAULT_MIXPANEL_NODE_HOST = 'api-eu.mixpanel.com';
7
4
  function envTruthy(name) {
8
5
  const value = process.env[name]?.trim().toLowerCase();
9
6
  return value === '1' || value === 'true' || value === 'yes';
@@ -14,21 +11,6 @@ export function isPostHogDisabledByEnv() {
14
11
  export function isAnalyticsDisabledByEnv() {
15
12
  return envTruthy('ANALYTICS_DISABLED') || isPostHogDisabledByEnv();
16
13
  }
17
- export function resolveAnalyticsProvider() {
18
- const value = process.env.ANALYTICS_PROVIDER?.trim().toLowerCase();
19
- if (value === 'posthog')
20
- return 'posthog';
21
- return 'mixpanel';
22
- }
23
- export function resolveMixpanelToken() {
24
- return process.env.MIXPANEL_TOKEN?.trim() || DEFAULT_MIXPANEL_TOKEN;
25
- }
26
- export function resolveMixpanelApiHost() {
27
- return process.env.MIXPANEL_API_HOST?.trim() || DEFAULT_MIXPANEL_API_HOST;
28
- }
29
- export function resolveMixpanelNodeHost() {
30
- return process.env.MIXPANEL_NODE_HOST?.trim() || DEFAULT_MIXPANEL_NODE_HOST;
31
- }
32
14
  export function resolvePostHogKey() {
33
15
  return process.env.POSTHOG_KEY?.trim() || DEFAULT_POSTHOG_KEY;
34
16
  }
@@ -42,9 +24,6 @@ export function hasPostHogKey() {
42
24
  return resolvePostHogKey().length > 0;
43
25
  }
44
26
  export function hasAnalyticsKey() {
45
- if (resolveAnalyticsProvider() === 'posthog') {
46
- return hasPostHogKey();
47
- }
48
- return resolveMixpanelToken().length > 0;
27
+ return hasPostHogKey();
49
28
  }
50
29
  //# sourceMappingURL=config.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,kDAAkD,CAAC;AAC/E,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAEjD,MAAM,sBAAsB,GAAG,kCAAkC,CAAC;AAClE,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AAChE,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAIzD,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,SAAS,CAAC,oBAAoB,CAAC,IAAI,sBAAsB,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,sBAAsB,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,yBAAyB,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,IAAI,0BAA0B,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,mBAAmB,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,eAAe,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,iBAAiB,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,wBAAwB,EAAE,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,aAAa,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,oBAAoB,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3C,CAAC"}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,kDAAkD,CAAC;AAC/E,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAEjD,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,SAAS,CAAC,kBAAkB,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,SAAS,CAAC,oBAAoB,CAAC,IAAI,sBAAsB,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,mBAAmB,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,eAAe,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,iBAAiB,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC"}
@@ -0,0 +1,20 @@
1
+ import type { AnalyticsEvent, AnalyticsProvider } from './types.js';
2
+ export declare class Ga4NodeProvider implements AnalyticsProvider {
3
+ private logger;
4
+ private clientId;
5
+ private measurementId;
6
+ private apiSecret;
7
+ private enabled;
8
+ private userProperties;
9
+ private pending;
10
+ constructor();
11
+ private trackPending;
12
+ private identifyPerson;
13
+ identify(properties?: Record<string, unknown>): void;
14
+ setPersonOnce(properties: Record<string, unknown>): void;
15
+ capture(event: AnalyticsEvent): void;
16
+ private send;
17
+ flush(): Promise<void>;
18
+ shutdown(): Promise<void>;
19
+ }
20
+ //# sourceMappingURL=ga4-node.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ga4-node.d.ts","sourceRoot":"","sources":["../../src/analytics/ga4-node.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAepE,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,OAAO,CAA4B;;IAmB3C,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,cAAc;IAItB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IASpD,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAsBxD,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAuBpC,OAAO,CAAC,IAAI;IAiBN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}
@@ -0,0 +1,117 @@
1
+ /**
2
+ * GA4 Measurement Protocol analytics provider (Node/server + MCP surfaces).
3
+ * Reference: https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference
4
+ *
5
+ * GA4 MP has no standalone identify or set_once call: user properties ride
6
+ * along with events. We accumulate them locally and attach them to each event.
7
+ */
8
+ import { randomUUID } from 'node:crypto';
9
+ import { Logger } from '../utils/logger.js';
10
+ import { hasGa4ApiSecret, resolveGa4ApiSecret, resolveGa4MeasurementId } from './config.js';
11
+ import { buildPersonIdentifyProperties, sanitizePersonOnceProperties } from './events.js';
12
+ import { getOrCreateDistinctId, hasPersonOnceProperty, markPersonOnceProperty, } from './identity.js';
13
+ import { mapGa4EventName, sanitizeGa4EventParams, sanitizeGa4UserProperties, } from './ga4-shared.js';
14
+ const GA4_COLLECT_ENDPOINT = 'https://www.google-analytics.com/mp/collect';
15
+ export class Ga4NodeProvider {
16
+ logger = new Logger('Analytics');
17
+ clientId;
18
+ measurementId;
19
+ apiSecret;
20
+ enabled;
21
+ userProperties = {};
22
+ pending = new Set();
23
+ constructor() {
24
+ this.clientId = getOrCreateDistinctId();
25
+ this.measurementId = resolveGa4MeasurementId();
26
+ this.apiSecret = resolveGa4ApiSecret();
27
+ this.enabled = hasGa4ApiSecret();
28
+ if (!this.enabled) {
29
+ // Provider still constructs (browser can send with the measurement ID
30
+ // alone), but the server surface cannot send without an API secret.
31
+ this.logger.debug('GA4_API_SECRET missing; GA4 node analytics disabled (no-op)');
32
+ return;
33
+ }
34
+ this.identifyPerson();
35
+ this.setPersonOnce({ first_install_at: new Date().toISOString() });
36
+ }
37
+ trackPending(promise) {
38
+ this.pending.add(promise);
39
+ void promise.finally(() => {
40
+ this.pending.delete(promise);
41
+ });
42
+ }
43
+ identifyPerson() {
44
+ this.identify({ event_source: 'server' });
45
+ }
46
+ identify(properties) {
47
+ if (!this.enabled) {
48
+ this.logger.debug('GA4 identify skipped (no API secret)');
49
+ return;
50
+ }
51
+ const props = buildPersonIdentifyProperties(properties);
52
+ Object.assign(this.userProperties, sanitizeGa4UserProperties(props));
53
+ }
54
+ setPersonOnce(properties) {
55
+ if (!this.enabled) {
56
+ this.logger.debug('GA4 setPersonOnce skipped (no API secret)');
57
+ return;
58
+ }
59
+ const props = sanitizePersonOnceProperties(properties);
60
+ // Emulate set_once: only apply keys that have not been persisted before.
61
+ const fresh = {};
62
+ for (const [key, value] of Object.entries(props)) {
63
+ if (hasPersonOnceProperty(key))
64
+ continue;
65
+ fresh[key] = value;
66
+ }
67
+ if (Object.keys(fresh).length === 0)
68
+ return;
69
+ const userProps = sanitizeGa4UserProperties(fresh);
70
+ Object.assign(this.userProperties, userProps);
71
+ for (const key of Object.keys(userProps)) {
72
+ markPersonOnceProperty(key);
73
+ }
74
+ }
75
+ capture(event) {
76
+ if (!this.enabled) {
77
+ this.logger.debug('GA4 capture skipped (no API secret)');
78
+ return;
79
+ }
80
+ const params = sanitizeGa4EventParams(event.properties);
81
+ // Required so MP events surface in Realtime reports.
82
+ params.engagement_time_msec = 1;
83
+ // Dedup key: GA4 event_id.
84
+ params.event_id = event.insertId ?? randomUUID();
85
+ const payload = {
86
+ client_id: this.clientId,
87
+ events: [{ name: mapGa4EventName(event.name), params }],
88
+ };
89
+ if (Object.keys(this.userProperties).length > 0) {
90
+ payload.user_properties = { ...this.userProperties };
91
+ }
92
+ this.send(payload);
93
+ }
94
+ send(payload) {
95
+ const url = `${GA4_COLLECT_ENDPOINT}?measurement_id=${encodeURIComponent(this.measurementId)}` +
96
+ `&api_secret=${encodeURIComponent(this.apiSecret)}`;
97
+ const promise = fetch(url, {
98
+ method: 'POST',
99
+ headers: { 'Content-Type': 'application/json' },
100
+ body: JSON.stringify(payload),
101
+ })
102
+ .then(() => undefined)
103
+ .catch((err) => {
104
+ this.logger.debug('Failed to send GA4 analytics event', err);
105
+ });
106
+ this.trackPending(promise);
107
+ }
108
+ async flush() {
109
+ if (this.pending.size === 0)
110
+ return;
111
+ await Promise.allSettled([...this.pending]);
112
+ }
113
+ async shutdown() {
114
+ await this.flush();
115
+ }
116
+ }
117
+ //# sourceMappingURL=ga4-node.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ga4-node.js","sourceRoot":"","sources":["../../src/analytics/ga4-node.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Shared GA4 Measurement Protocol sanitization.
3
+ * Reused by the Node provider (Phase 2) and the browser provider (Phase 3).
4
+ * Reference: https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference
5
+ */
6
+ import type { AnalyticsPropertyValue } from './types.js';
7
+ /** Map internal event names onto GA4 event names (lowercased, `$` stripped). */
8
+ export declare function mapGa4EventName(name: string): string;
9
+ /** Enforce GA4 event-param limits, map page fields, and stringify arrays. */
10
+ export declare function sanitizeGa4EventParams(params: Record<string, AnalyticsPropertyValue> | undefined): Record<string, string | number>;
11
+ /** Format person properties as GA4 user_properties, enforcing name/value limits. */
12
+ export declare function sanitizeGa4UserProperties(props: Record<string, unknown> | undefined): Record<string, {
13
+ value: string;
14
+ }>;
15
+ //# sourceMappingURL=ga4-shared.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ga4-shared.d.ts","sourceRoot":"","sources":["../../src/analytics/ga4-shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAwCzD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAkBD,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,SAAS,GACzD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAoBjC;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBnC"}
@@ -0,0 +1,119 @@
1
+ // GA4 Measurement Protocol limits.
2
+ const EVENT_NAME_MAX = 40;
3
+ const PARAM_NAME_MAX = 40;
4
+ const PARAM_VALUE_MAX = 100;
5
+ const USER_PROPERTY_NAME_MAX = 24;
6
+ const USER_PROPERTY_VALUE_MAX = 36;
7
+ const MAX_PARAMS_PER_EVENT = 25;
8
+ const MAX_USER_PROPERTIES = 25;
9
+ // Reserved param-name prefixes GA4 rejects.
10
+ const RESERVED_PARAM_PREFIXES = ['_', 'firebase_', 'ga_', 'google_', 'gtag.'];
11
+ // Reserved user-property name prefixes GA4 rejects.
12
+ const RESERVED_USER_PROPERTY_PREFIXES = ['google_', 'ga_', 'firebase_'];
13
+ // Reserved user-property names GA4 rejects.
14
+ const RESERVED_USER_PROPERTY_NAMES = new Set([
15
+ 'first_open_time',
16
+ 'first_visit_time',
17
+ 'last_deep_link_referrer',
18
+ 'user_id',
19
+ 'first_open_after_install',
20
+ ]);
21
+ // PostHog-style page fields mapped onto GA4 recommended params.
22
+ const PAGE_PARAM_MAP = {
23
+ $current_url: 'page_location',
24
+ $pathname: 'page_path',
25
+ };
26
+ const VALID_NAME = /^[A-Za-z][A-Za-z0-9_]*$/;
27
+ function truncate(value, max) {
28
+ return value.length > max ? value.slice(0, max) : value;
29
+ }
30
+ function hasReservedPrefix(name, prefixes) {
31
+ return prefixes.some((prefix) => name.startsWith(prefix));
32
+ }
33
+ /** Map internal event names onto GA4 event names (lowercased, `$` stripped). */
34
+ export function mapGa4EventName(name) {
35
+ const trimmed = name.trim();
36
+ if (trimmed === '$pageview')
37
+ return 'page_view';
38
+ if (trimmed === '$pageleave')
39
+ return 'page_leave';
40
+ const normalized = trimmed.replace(/^\$/, '').toLowerCase();
41
+ return truncate(normalized, EVENT_NAME_MAX);
42
+ }
43
+ function coerceParamValue(value) {
44
+ if (value === null || value === undefined)
45
+ return undefined;
46
+ if (Array.isArray(value)) {
47
+ const joined = value.filter((item) => typeof item === 'string' && item.trim()).join(',');
48
+ return joined ? truncate(joined, PARAM_VALUE_MAX) : undefined;
49
+ }
50
+ if (typeof value === 'number') {
51
+ return Number.isFinite(value) ? value : undefined;
52
+ }
53
+ if (typeof value === 'boolean')
54
+ return String(value);
55
+ if (typeof value === 'string') {
56
+ return value ? truncate(value, PARAM_VALUE_MAX) : undefined;
57
+ }
58
+ return undefined;
59
+ }
60
+ /** Enforce GA4 event-param limits, map page fields, and stringify arrays. */
61
+ export function sanitizeGa4EventParams(params) {
62
+ const out = {};
63
+ if (!params)
64
+ return out;
65
+ let count = 0;
66
+ for (const [rawKey, rawValue] of Object.entries(params)) {
67
+ if (count >= MAX_PARAMS_PER_EVENT)
68
+ break;
69
+ const name = PAGE_PARAM_MAP[rawKey] ?? rawKey;
70
+ if (!VALID_NAME.test(name))
71
+ continue;
72
+ if (name.length > PARAM_NAME_MAX)
73
+ continue;
74
+ if (hasReservedPrefix(name, RESERVED_PARAM_PREFIXES))
75
+ continue;
76
+ const value = coerceParamValue(rawValue);
77
+ if (value === undefined)
78
+ continue;
79
+ out[name] = value;
80
+ count += 1;
81
+ }
82
+ return out;
83
+ }
84
+ /** Format person properties as GA4 user_properties, enforcing name/value limits. */
85
+ export function sanitizeGa4UserProperties(props) {
86
+ const out = {};
87
+ if (!props)
88
+ return out;
89
+ let count = 0;
90
+ for (const [name, rawValue] of Object.entries(props)) {
91
+ if (count >= MAX_USER_PROPERTIES)
92
+ break;
93
+ if (!VALID_NAME.test(name))
94
+ continue;
95
+ if (name.length > USER_PROPERTY_NAME_MAX)
96
+ continue;
97
+ if (RESERVED_USER_PROPERTY_NAMES.has(name))
98
+ continue;
99
+ if (hasReservedPrefix(name, RESERVED_USER_PROPERTY_PREFIXES))
100
+ continue;
101
+ if (rawValue === null || rawValue === undefined)
102
+ continue;
103
+ let stringValue;
104
+ if (typeof rawValue === 'string')
105
+ stringValue = rawValue;
106
+ else if (typeof rawValue === 'number')
107
+ stringValue = Number.isFinite(rawValue) ? String(rawValue) : '';
108
+ else if (typeof rawValue === 'boolean')
109
+ stringValue = String(rawValue);
110
+ else
111
+ continue;
112
+ if (!stringValue)
113
+ continue;
114
+ out[name] = { value: truncate(stringValue, USER_PROPERTY_VALUE_MAX) };
115
+ count += 1;
116
+ }
117
+ return out;
118
+ }
119
+ //# sourceMappingURL=ga4-shared.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ga4-shared.js","sourceRoot":"","sources":["../../src/analytics/ga4-shared.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAYjD,OAAO,EACL,qBAAqB,EAIrB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAA2B,MAAM,eAAe,CAAC;AAC9F,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,sFAAsF;AACtF,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAED,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,IAAI,CAON;AAED,wBAAgB,uBAAuB,CACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAgBN;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG9D;AAED,4FAA4F;AAC5F,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAYhF;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CA0BlE;AAED,OAAO,EACL,6BAA6B,GAC9B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,CAAC;AACF,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,GACb,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AASjD,OAAO,EACL,qBAAqB,EAIrB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAA2B,MAAM,eAAe,CAAC;AAC9F,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,sFAAsF;AACtF,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAED,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,IAAI,CAON;AAED,wBAAgB,uBAAuB,CACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAgBN;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG9D;AAED,4FAA4F;AAC5F,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAYhF;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CAalE;AACD,OAAO,EACL,6BAA6B,GAC9B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,CAAC;AACF,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,GACb,CAAC"}
@@ -1,6 +1,6 @@
1
1
  import { captureBetaChatTurn } from './beta-telemetry.js';
2
2
  import { getAppVersion } from './app-version.js';
3
- import { hasAnalyticsKey, resolveAnalyticsProvider, resolveMixpanelApiHost, resolveMixpanelToken, resolvePostHogApiHost, resolvePostHogKey, resolvePostHogUiHost, } from './config.js';
3
+ import { hasAnalyticsKey, resolvePostHogApiHost, resolvePostHogKey, resolvePostHogUiHost, } from './config.js';
4
4
  import { buildPersonIdentifyProperties, buildRuntimeProperties } from './events.js';
5
5
  import { applyInstallCohortPersonOnce } from './install-cohorts.js';
6
6
  import { getBetaTelemetryState, getOrCreateDistinctId, isAnalyticsEnabled, recordUsageSurface, setBetaTelemetryChoice, } from './identity.js';
@@ -65,24 +65,11 @@ export async function shutdownAnalytics() {
65
65
  await shutdownAnalyticsClient();
66
66
  }
67
67
  export function getAnalyticsRuntimeConfig() {
68
- const provider = resolveAnalyticsProvider();
69
68
  const enabled = isAnalyticsEnabled() && hasAnalyticsKey();
70
69
  const beta = getBetaTelemetryState();
71
- if (provider === 'mixpanel') {
72
- return {
73
- enabled,
74
- provider,
75
- key: resolveMixpanelToken(),
76
- apiHost: resolveMixpanelApiHost(),
77
- uiHost: '',
78
- distinctId: getOrCreateDistinctId(),
79
- betaTelemetryOptIn: beta.betaTelemetryOptIn,
80
- betaTelemetryPromptAnswered: beta.betaTelemetryPromptAnswered,
81
- };
82
- }
83
70
  return {
84
71
  enabled,
85
- provider,
72
+ provider: 'posthog',
86
73
  key: resolvePostHogKey(),
87
74
  apiHost: resolvePostHogApiHost(),
88
75
  uiHost: resolvePostHogUiHost(),
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"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"}
@@ -2,7 +2,7 @@ export type InstallUsageSurface = 'mcp' | 'server' | 'web';
2
2
  /** Maps internal usage_surface values to install-cohort person properties. */
3
3
  export declare function normalizeInstallUsageSurface(surface: string): InstallUsageSurface;
4
4
  /**
5
- * Mixpanel/PostHog people.set_once install cohort fields — safe to call repeatedly.
5
+ * PostHog $set_once install cohort fields — safe to call repeatedly.
6
6
  * See docs/anonymous-usage-analytics.md (person profile cohorts).
7
7
  */
8
8
  export declare function applyInstallCohortPersonOnce(params: {
@@ -10,7 +10,7 @@ export function normalizeInstallUsageSurface(surface) {
10
10
  return 'server';
11
11
  }
12
12
  /**
13
- * Mixpanel/PostHog people.set_once install cohort fields — safe to call repeatedly.
13
+ * PostHog $set_once install cohort fields — safe to call repeatedly.
14
14
  * See docs/anonymous-usage-analytics.md (person profile cohorts).
15
15
  */
16
16
  export function applyInstallCohortPersonOnce(params) {
@@ -1,7 +1,7 @@
1
1
  export type AnalyticsMilestone = 'mcp_first_tool_success' | 'mcp_photoshop_first_connected';
2
2
  /**
3
3
  * Fires a one-time funnel milestone per install. Uses a persisted flag plus a
4
- * deterministic $insert_id so Mixpanel deduplicates accidental double-sends.
4
+ * deterministic uuid so PostHog deduplicates accidental double-sends.
5
5
  */
6
6
  export declare function captureAnalyticsMilestoneOnce(milestone: AnalyticsMilestone, properties?: Record<string, unknown>): boolean;
7
7
  //# sourceMappingURL=milestones.d.ts.map
@@ -4,7 +4,7 @@ import { getOrCreateDistinctId, hasAnalyticsMilestone, isAnalyticsEnabled, markA
4
4
  import { getAnalytics } from './provider.js';
5
5
  /**
6
6
  * Fires a one-time funnel milestone per install. Uses a persisted flag plus a
7
- * deterministic $insert_id so Mixpanel deduplicates accidental double-sends.
7
+ * deterministic uuid so PostHog deduplicates accidental double-sends.
8
8
  */
9
9
  export function captureAnalyticsMilestoneOnce(milestone, properties = {}) {
10
10
  if (!isAnalyticsEnabled() || !hasAnalyticsKey())