@alisaitteke/photoshop-mcp 1.3.0 → 1.3.5

package/README.md

@@ -644,65 +644,9 @@ MIT
 
 ## Anonymous Usage Analytics
 
-This project collects **anonymous, aggregated usage events** to understand how the
-MCP server and standalone UI are used and to improve the product. Analytics are
-**enabled by default** and can be turned off at any time.
-
-### What we collect
-
-- App version, operating system, and Node.js version
-- Startup signals (MCP server or UI server started, Photoshop detected or not)
-- Setup funnel events (provider chosen, auth method, validation success/failure
-  codes — not credentials)
-- Generic UI events (app loaded, onboarding completed)
-
-Events use a random anonymous identifier stored locally at
-`~/.photoshop-mcp/` (SQLite `kv` table and/or `analytics-store.json`). We do
-**not** call `identify()` — no person profiles are created for anonymous usage
-(`person_profiles: identified_only`).
-
-### What we do **not** collect (unless you opt into beta team sharing)
-
-- API keys or OAuth tokens
-- Chat messages, prompts, or model responses **by default**
-- Photoshop document or layer names, file paths, or image content
-- CLI account labels, email addresses, or other account identifiers
-- Tool call arguments or results
-
-### Beta team content sharing (opt-in)
-
-On first launch of the standalone UI, you are asked whether you want to **join the
-beta team**. This is separate from anonymous usage analytics above.
-
-If you accept:
-
-- Your **prompts**, **assistant responses**, **reasoning text**, and **tool names**
-  (not arguments or results) may be sent to PostHog after each chat turn
-- Content is truncated for very long messages
-- Requires anonymous analytics to remain enabled
-
-If you decline, no chat content is logged. You can change this later in
-**Settings → General → Privacy → Beta team content sharing**.
-
-Existing installs that have not answered yet are prompted once on the next launch.
-
-### Processor and hosting
-
-Analytics are processed by [PostHog](https://posthog.com/). Events are sent to a
-managed reverse proxy at `https://a.alisait.com`; the PostHog project UI is
-hosted in the EU (`https://eu.posthog.com`). See the
-[PostHog privacy policy](https://posthog.com/privacy) for how PostHog handles
-data on their side.
-
-### How to opt out
-
-1. **Standalone UI:** Settings → General → Privacy → set **Anonymous usage
-   analytics** to **Off** (also disables beta content sharing).
-2. **Beta content only:** Settings → General → Privacy → set **Beta team content
-   sharing** to **Off** (anonymous analytics can stay on).
-3. **Environment variable:** set `POSTHOG_DISABLED=1` before starting
-   `photoshop-mcp` or `photoshop-mcp-ui` (disables all analytics for that
-   process and persists opt-out in local storage).
+Anonymous, aggregated usage events are collected by default to improve the
+product. You can opt out at any time. Full details:
+[`docs/anonymous-usage-analytics.md`](docs/anonymous-usage-analytics.md).
 
 ## Acknowledgments
 

package/dist/analytics/client-ip.d.ts

@@ -0,0 +1,5 @@
+/** Best-effort client IP from an incoming HTTP request (may be loopback for local UI). */
+export declare function resolveClientIp(headers: Headers): string | undefined;
+/** GeoIP enrichment only makes sense for a routable public client address. */
+export declare function isPublicClientIp(ip: string | undefined): boolean;
+//# sourceMappingURL=client-ip.d.ts.map

package/dist/analytics/client-ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-ip.d.ts","sourceRoot":"","sources":["../../src/analytics/client-ip.ts"],"names":[],"mappings":"AAYA,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAapE;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGhE"}

package/dist/analytics/client-ip.js

@@ -0,0 +1,39 @@
+function isLoopbackOrPrivateIp(ip) {
+    const normalized = ip.trim().toLowerCase();
+    if (!normalized)
+        return true;
+    if (normalized === '::1' || normalized === 'localhost')
+        return true;
+    if (normalized.startsWith('127.'))
+        return true;
+    if (normalized.startsWith('10.'))
+        return true;
+    if (normalized.startsWith('192.168.'))
+        return true;
+    if (/^172\.(1[6-9]|2\d|3[01])\./.test(normalized))
+        return true;
+    if (normalized.startsWith('fc') || normalized.startsWith('fd'))
+        return true;
+    return false;
+}
+/** Best-effort client IP from an incoming HTTP request (may be loopback for local UI). */
+export function resolveClientIp(headers) {
+    const candidates = [
+        headers.get('cf-connecting-ip'),
+        headers.get('x-real-ip'),
+        ...(headers.get('x-forwarded-for')?.split(',') ?? []),
+    ];
+    for (const raw of candidates) {
+        const ip = raw?.trim();
+        if (ip)
+            return ip;
+    }
+    return undefined;
+}
+/** GeoIP enrichment only makes sense for a routable public client address. */
+export function isPublicClientIp(ip) {
+    if (!ip)
+        return false;
+    return !isLoopbackOrPrivateIp(ip);
+}
+//# sourceMappingURL=client-ip.js.map

package/dist/analytics/client-ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-ip.js","sourceRoot":"","sources":["../../src/analytics/client-ip.ts"],"names":[],"mappings":"AAAA,SAAS,qBAAqB,CAAC,EAAU;IACvC,MAAM,UAAU,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,4BAA4B,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QACxB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;KACtD,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;QACvB,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,EAAsB;IACrD,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IACtB,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/analytics/events.d.ts

@@ -1,3 +1,5 @@
 export declare function sanitizeAnalyticsProperties(properties: Record<string, unknown> | undefined): Record<string, string | number | boolean>;
 export declare function buildRuntimeProperties(properties: Record<string, unknown> | undefined): Record<string, string | number | boolean>;
+/** Person-profile fields merged on PostHog identify() — includes install-level hardware signals. */
+export declare function buildPersonIdentifyProperties(properties?: Record<string, unknown>): Record<string, string | number | boolean>;
 //# sourceMappingURL=events.d.ts.map

package/dist/analytics/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"AAiDA,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAc3C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAS3C"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"AA6FA,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAa3C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAO3C;AAED,oGAAoG;AACpG,wBAAgB,6BAA6B,CAC3C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAK3C"}

package/dist/analytics/events.js

@@ -1,5 +1,6 @@
 import { getServerAnalyticsContext } from './context.js';
 import { getLaunchMethod } from './launch-method.js';
+import { buildAnonymousRuntimeEnv, getTotalRamGb } from './runtime-env.js';
 const BLOCKED_PROPERTY_KEYS = new Set([
     'api_key',
     'apikey',
@@ -29,6 +30,7 @@ const ALLOWED_PROPERTY_KEYS = new Set([
     'ok',
     'error_code',
     'photoshop_detected',
+    'photoshop_connected',
     'action_plan_enabled',
     'event_source',
     'port',
@@ -43,33 +45,78 @@ const ALLOWED_PROPERTY_KEYS = new Set([
     'beta_telemetry_opt_in',
     'theme',
     'launch_method',
+    'browser_language',
+    'browser_timezone',
+    'browser_locale_region',
+    'system_locale',
+    'system_locale_region',
+    'system_locale_language',
+    'system_timezone',
+    'os_type',
+    'os_release',
+    'cpu_count',
+    'memory_gb',
+    'total_ram_gb',
+    'photoshop_version',
+    'node_major',
+    'is_electron',
+    'photoshop_path_configured',
+    'custom_data_dir_configured',
+    'tool_name',
+    'duration_ms',
+    'usage_surface',
+    'shutdown_reason',
+    'tools_registered_count',
+    'prompt_name',
+    'tools_called_count',
+    'tools_error_count',
+    'unique_tools_count',
+    'tool_usage_summary',
+    'error_codes_summary',
+    'batch_flush_reason',
 ]);
+const POSTHOG_RESERVED_PROPERTY_KEYS = new Set([
+    '$current_url',
+    '$pathname',
+    '$screen_name',
+]);
+function isAllowedAnalyticsPropertyKey(key) {
+    const normalized = key.toLowerCase();
+    if (BLOCKED_PROPERTY_KEYS.has(normalized))
+        return false;
+    if (ALLOWED_PROPERTY_KEYS.has(normalized))
+        return true;
+    return POSTHOG_RESERVED_PROPERTY_KEYS.has(key);
+}
 export function sanitizeAnalyticsProperties(properties) {
     if (!properties)
         return {};
     const out = {};
     for (const [key, value] of Object.entries(properties)) {
-        const normalized = key.toLowerCase();
-        if (BLOCKED_PROPERTY_KEYS.has(normalized))
-            continue;
-        if (!ALLOWED_PROPERTY_KEYS.has(normalized))
+        if (!isAllowedAnalyticsPropertyKey(key))
             continue;
         if (value === null || value === undefined)
             continue;
         if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
-            out[normalized] = value;
+            const outKey = POSTHOG_RESERVED_PROPERTY_KEYS.has(key) ? key : key.toLowerCase();
+            out[outKey] = value;
         }
     }
     return out;
 }
 export function buildRuntimeProperties(properties) {
     return {
-        os: process.platform,
-        arch: process.arch,
-        node_version: process.version,
+        ...buildAnonymousRuntimeEnv(),
         launch_method: getLaunchMethod(),
         ...getServerAnalyticsContext(),
         ...sanitizeAnalyticsProperties(properties),
     };
 }
+/** Person-profile fields merged on PostHog identify() — includes install-level hardware signals. */
+export function buildPersonIdentifyProperties(properties) {
+    return buildRuntimeProperties({
+        total_ram_gb: getTotalRamGb(),
+        ...properties,
+    });
+}
 //# sourceMappingURL=events.js.map

package/dist/analytics/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,SAAS;IACT,QAAQ;IACR,KAAK;IACL,OAAO;IACP,QAAQ;IACR,UAAU;IACV,OAAO;IACP,eAAe;IACf,UAAU;IACV,MAAM;IACN,WAAW;IACX,UAAU;IACV,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,aAAa;IACb,IAAI;IACJ,MAAM;IACN,cAAc;IACd,aAAa;IACb,aAAa;IACb,IAAI;IACJ,YAAY;IACZ,oBAAoB;IACpB,qBAAqB;IACrB,cAAc;IACd,MAAM;IACN,MAAM;IACN,SAAS;IACT,UAAU;IACV,iBAAiB;IACjB,WAAW;IACX,UAAU;IACV,cAAc;IACd,mBAAmB;IACnB,uBAAuB;IACvB,OAAO;IACP,eAAe;CAChB,CAAC,CAAC;AAEH,MAAM,UAAU,2BAA2B,CACzC,UAA+C;IAE/C,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAE3B,MAAM,GAAG,GAA8C,EAAE,CAAC;IAC1D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACpD,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACrD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YACzF,GAAG,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAA+C;IAE/C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,QAAQ;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,YAAY,EAAE,OAAO,CAAC,OAAO;QAC7B,aAAa,EAAE,eAAe,EAAE;QAChC,GAAG,yBAAyB,EAAE;QAC9B,GAAG,2BAA2B,CAAC,UAAU,CAAC;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/analytics/events.ts"],"names":[],"mappings":"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"}

package/dist/analytics/index.d.ts

@@ -1,10 +1,16 @@
 import { captureBetaChatTurn } from './beta-telemetry.js';
 import { getBetaTelemetryState, setBetaTelemetryChoice } from './identity.js';
+import { endMcpAnalyticsSession, recordMcpToolCall, startMcpAnalyticsSession } from './mcp-session.js';
+import { captureMcpPageleave, captureMcpPageview } from './pageview.js';
 import { getAnalytics, resetAnalyticsProvider } from './provider.js';
-import type { AnalyticsEvent, AnalyticsProvider, AnalyticsRuntimeConfig, BetaTelemetryState } from './types.js';
+import type { AnalyticsEvent, AnalyticsProvider, AnalyticsRuntimeConfig, BetaTelemetryState, UsageSurface } from './types.js';
+export type { McpShutdownReason } from './mcp-session.js';
+/** Persist the install ID and register one anonymous PostHog person per process. */
+export declare function ensureAnalyticsIdentity(): void;
 export declare function capture(name: string, properties?: Record<string, unknown>): void;
+export declare function identifyAnalyticsPerson(properties?: Record<string, unknown>): void;
 export declare function shutdownAnalytics(): Promise<void>;
 export declare function getAnalyticsRuntimeConfig(): AnalyticsRuntimeConfig;
-export { captureBetaChatTurn, getAnalytics, getBetaTelemetryState, resetAnalyticsProvider, setBetaTelemetryChoice, };
-export type { AnalyticsEvent, AnalyticsProvider, AnalyticsRuntimeConfig, BetaTelemetryState };
+export { captureBetaChatTurn, captureMcpPageleave, captureMcpPageview, endMcpAnalyticsSession, getAnalytics, getBetaTelemetryState, recordMcpToolCall, resetAnalyticsProvider, setBetaTelemetryChoice, startMcpAnalyticsSession, };
+export type { AnalyticsEvent, AnalyticsProvider, AnalyticsRuntimeConfig, BetaTelemetryState, UsageSurface, };
 //# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ1D,OAAO,EACL,qBAAqB,EAGrB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAA2B,MAAM,eAAe,CAAC;AAC9F,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAMN;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CAYlE;AAED,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,GACvB,CAAC;AACF,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ1D,OAAO,EACL,qBAAqB,EAGrB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AACvB,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,oFAAoF;AACpF,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAED,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAMN;AAED,wBAAgB,uBAAuB,CACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAGN;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CAYlE;AAED,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,CAAC;AACF,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,GACb,CAAC"}

package/dist/analytics/index.js

@@ -2,7 +2,16 @@ import { captureBetaChatTurn } from './beta-telemetry.js';
 import { hasPostHogKey, resolvePostHogApiHost, resolvePostHogKey, resolvePostHogUiHost, } from './config.js';
 import { buildRuntimeProperties } from './events.js';
 import { getBetaTelemetryState, getOrCreateDistinctId, isAnalyticsEnabled, setBetaTelemetryChoice, } from './identity.js';
+import { endMcpAnalyticsSession, recordMcpToolCall, startMcpAnalyticsSession, } from './mcp-session.js';
+import { captureMcpPageleave, captureMcpPageview } from './pageview.js';
 import { getAnalytics, resetAnalyticsProvider, shutdownAnalyticsClient } from './provider.js';
+/** Persist the install ID and register one anonymous PostHog person per process. */
+export function ensureAnalyticsIdentity() {
+    if (!isAnalyticsEnabled() || !hasPostHogKey())
+        return;
+    getOrCreateDistinctId();
+    getAnalytics();
+}
 export function capture(name, properties) {
     if (!isAnalyticsEnabled() || !hasPostHogKey())
         return;
@@ -11,6 +20,11 @@ export function capture(name, properties) {
         properties: buildRuntimeProperties(properties),
     });
 }
+export function identifyAnalyticsPerson(properties) {
+    if (!isAnalyticsEnabled() || !hasPostHogKey())
+        return;
+    getAnalytics().identify(properties);
+}
 export async function shutdownAnalytics() {
     await shutdownAnalyticsClient();
 }
@@ -27,5 +41,5 @@ export function getAnalyticsRuntimeConfig() {
         betaTelemetryPromptAnswered: beta.betaTelemetryPromptAnswered,
     };
 }
-export { captureBetaChatTurn, getAnalytics, getBetaTelemetryState, resetAnalyticsProvider, setBetaTelemetryChoice, };
+export { captureBetaChatTurn, captureMcpPageleave, captureMcpPageview, endMcpAnalyticsSession, getAnalytics, getBetaTelemetryState, recordMcpToolCall, resetAnalyticsProvider, setBetaTelemetryChoice, startMcpAnalyticsSession, };
 //# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAQ9F,MAAM,UAAU,OAAO,CACrB,IAAY,EACZ,UAAoC;IAEpC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IACtD,YAAY,EAAE,CAAC,OAAO,CAAC;QACrB,IAAI;QACJ,UAAU,EAAE,sBAAsB,CAAC,UAAU,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,uBAAuB,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,MAAM,OAAO,GAAG,kBAAkB,EAAE,IAAI,aAAa,EAAE,CAAC;IACxD,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,OAAO;QACL,OAAO;QACP,GAAG,EAAE,iBAAiB,EAAE;QACxB,OAAO,EAAE,qBAAqB,EAAE;QAChC,MAAM,EAAE,oBAAoB,EAAE;QAC9B,UAAU,EAAE,qBAAqB,EAAE;QACnC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,2BAA2B,EAAE,IAAI,CAAC,2BAA2B;KAC9D,CAAC;AACJ,CAAC;AAED,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,GACvB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAU9F,oFAAoF;AACpF,MAAM,UAAU,uBAAuB;IACrC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IACtD,qBAAqB,EAAE,CAAC;IACxB,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,IAAY,EACZ,UAAoC;IAEpC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IACtD,YAAY,EAAE,CAAC,OAAO,CAAC;QACrB,IAAI;QACJ,UAAU,EAAE,sBAAsB,CAAC,UAAU,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAAoC;IAEpC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IACtD,YAAY,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,uBAAuB,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,MAAM,OAAO,GAAG,kBAAkB,EAAE,IAAI,aAAa,EAAE,CAAC;IACxD,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,OAAO;QACL,OAAO;QACP,GAAG,EAAE,iBAAiB,EAAE;QACxB,OAAO,EAAE,qBAAqB,EAAE;QAChC,MAAM,EAAE,oBAAoB,EAAE;QAC9B,UAAU,EAAE,qBAAqB,EAAE;QACnC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,2BAA2B,EAAE,IAAI,CAAC,2BAA2B;KAC9D,CAAC;AACJ,CAAC;AAED,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,CAAC"}

package/dist/analytics/locale.d.ts

@@ -0,0 +1,6 @@
+export declare function getSystemLocale(): string;
+/** Region subtag from a BCP-47 locale (e.g. en-US -> US, tr-TR -> TR). */
+export declare function resolveLocaleRegion(locale: string): string | undefined;
+/** Primary language subtag from a BCP-47 locale (e.g. en-US -> en, tr-TR -> tr). */
+export declare function resolveLocaleLanguage(locale: string): string | undefined;
+//# sourceMappingURL=locale.d.ts.map

package/dist/analytics/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/analytics/locale.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxE"}

package/dist/analytics/locale.js

@@ -0,0 +1,19 @@
+export function getSystemLocale() {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().locale;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/** Region subtag from a BCP-47 locale (e.g. en-US -> US, tr-TR -> TR). */
+export function resolveLocaleRegion(locale) {
+    const match = locale.trim().match(/-([A-Za-z]{2})\b/);
+    return match?.[1]?.toUpperCase();
+}
+/** Primary language subtag from a BCP-47 locale (e.g. en-US -> en, tr-TR -> tr). */
+export function resolveLocaleLanguage(locale) {
+    const primary = locale.trim().split('-')[0]?.toLowerCase();
+    return primary || undefined;
+}
+//# sourceMappingURL=locale.js.map

package/dist/analytics/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../src/analytics/locale.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3D,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC"}

package/dist/analytics/mcp-session.d.ts

@@ -0,0 +1,12 @@
+export type McpShutdownReason = 'sigint' | 'sigterm' | 'error' | 'stdio_closed';
+export type McpToolBatchFlushReason = 'idle' | 'shutdown';
+export declare function flushMcpToolBatch(reason: McpToolBatchFlushReason): void;
+export declare function startMcpAnalyticsSession(): void;
+export declare function recordMcpToolCall(params: {
+    toolName: string;
+    ok: boolean;
+    errorCode?: string;
+    durationMs: number;
+}): void;
+export declare function endMcpAnalyticsSession(reason: McpShutdownReason): void;
+//# sourceMappingURL=mcp-session.d.ts.map

package/dist/analytics/mcp-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-session.d.ts","sourceRoot":"","sources":["../../src/analytics/mcp-session.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,UAAU,CAAC;AA6D1D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CA4BvE;AAUD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAuBP;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CActE"}

package/dist/analytics/mcp-session.js

@@ -0,0 +1,118 @@
+import { hasPostHogKey } from './config.js';
+import { buildRuntimeProperties } from './events.js';
+import { isAnalyticsEnabled } from './identity.js';
+import { captureMcpPageleave } from './pageview.js';
+import { getAnalytics } from './provider.js';
+/** Flush batched tool usage after this idle gap (proxy for end of an agent turn). */
+const IDLE_FLUSH_MS = 30_000;
+const MAX_SUMMARY_LENGTH = 4_000;
+let startedAt = null;
+let toolBatch = new Map();
+let idleFlushTimer = null;
+function captureMcpEvent(name, properties) {
+    if (!isAnalyticsEnabled() || !hasPostHogKey())
+        return;
+    getAnalytics().capture({
+        name,
+        properties: buildRuntimeProperties(properties),
+    });
+}
+function clearIdleFlushTimer() {
+    if (!idleFlushTimer)
+        return;
+    clearTimeout(idleFlushTimer);
+    idleFlushTimer = null;
+}
+function formatUsageSummary(batch) {
+    const parts = [...batch.entries()]
+        .sort((a, b) => b[1].ok + b[1].fail - (a[1].ok + a[1].fail))
+        .map(([name, entry]) => `${name}:${entry.ok + entry.fail}`);
+    let summary = parts.join(',');
+    if (summary.length > MAX_SUMMARY_LENGTH) {
+        summary = `${summary.slice(0, MAX_SUMMARY_LENGTH)}…`;
+    }
+    return summary;
+}
+function formatErrorCodesSummary(batch) {
+    const totals = new Map();
+    for (const entry of batch.values()) {
+        for (const [code, count] of entry.errors) {
+            totals.set(code, (totals.get(code) ?? 0) + count);
+        }
+    }
+    if (totals.size === 0)
+        return undefined;
+    return [...totals.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .map(([code, count]) => `${code}:${count}`)
+        .join(',');
+}
+export function flushMcpToolBatch(reason) {
+    if (toolBatch.size === 0)
+        return;
+    let toolsCalledCount = 0;
+    let toolsErrorCount = 0;
+    let totalDurationMs = 0;
+    for (const entry of toolBatch.values()) {
+        toolsCalledCount += entry.ok + entry.fail;
+        toolsErrorCount += entry.fail;
+        totalDurationMs += entry.durationMs;
+    }
+    const errorCodesSummary = formatErrorCodesSummary(toolBatch);
+    captureMcpEvent('mcp_tool_batch', {
+        tools_called_count: toolsCalledCount,
+        tools_error_count: toolsErrorCount,
+        unique_tools_count: toolBatch.size,
+        tool_usage_summary: formatUsageSummary(toolBatch),
+        ...(errorCodesSummary ? { error_codes_summary: errorCodesSummary } : {}),
+        batch_flush_reason: reason,
+        duration_ms: totalDurationMs,
+        event_source: 'mcp',
+    });
+    toolBatch.clear();
+    clearIdleFlushTimer();
+}
+function scheduleIdleFlush() {
+    clearIdleFlushTimer();
+    idleFlushTimer = setTimeout(() => {
+        idleFlushTimer = null;
+        flushMcpToolBatch('idle');
+    }, IDLE_FLUSH_MS);
+}
+export function startMcpAnalyticsSession() {
+    startedAt = Date.now();
+}
+export function recordMcpToolCall(params) {
+    const existing = toolBatch.get(params.toolName) ?? {
+        ok: 0,
+        fail: 0,
+        errors: new Map(),
+        durationMs: 0,
+    };
+    if (params.ok) {
+        existing.ok += 1;
+    }
+    else {
+        existing.fail += 1;
+        if (params.errorCode) {
+            existing.errors.set(params.errorCode, (existing.errors.get(params.errorCode) ?? 0) + 1);
+        }
+    }
+    existing.durationMs += params.durationMs;
+    toolBatch.set(params.toolName, existing);
+    scheduleIdleFlush();
+}
+export function endMcpAnalyticsSession(reason) {
+    flushMcpToolBatch('shutdown');
+    const durationMs = startedAt !== null ? Date.now() - startedAt : 0;
+    captureMcpPageleave(durationMs, reason);
+    captureMcpEvent('mcp_session_ended', {
+        duration_ms: durationMs,
+        shutdown_reason: reason,
+        event_source: 'mcp',
+    });
+    startedAt = null;
+    toolBatch.clear();
+    clearIdleFlushTimer();
+}
+//# sourceMappingURL=mcp-session.js.map

package/dist/analytics/mcp-session.js.map

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

package/dist/analytics/noop.d.ts

@@ -1,6 +1,7 @@
 import type { AnalyticsEvent, AnalyticsProvider } from './types.js';
 export declare class NoopAnalyticsProvider implements AnalyticsProvider {
     capture(_event: AnalyticsEvent): void;
+    identify(_properties?: Record<string, unknown>): void;
     shutdown(): Promise<void>;
 }
 //# sourceMappingURL=noop.d.ts.map

package/dist/analytics/noop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../src/analytics/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpE,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAI/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../src/analytics/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpE,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/analytics/noop.js

@@ -2,6 +2,9 @@ export class NoopAnalyticsProvider {
     capture(_event) {
         // intentionally empty
     }
+    identify(_properties) {
+        // intentionally empty
+    }
     async shutdown() {
         // intentionally empty
     }

package/dist/analytics/noop.js.map

@@ -1 +1 @@
-{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../src/analytics/noop.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAqB;IAChC,OAAO,CAAC,MAAsB;QAC5B,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,sBAAsB;IACxB,CAAC;CACF"}
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../src/analytics/noop.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAqB;IAChC,OAAO,CAAC,MAAsB;QAC5B,sBAAsB;IACxB,CAAC;IAED,QAAQ,CAAC,WAAqC;QAC5C,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,sBAAsB;IACxB,CAAC;CACF"}

package/dist/analytics/pageview.d.ts

@@ -0,0 +1,3 @@
+export declare function captureMcpPageview(): void;
+export declare function captureMcpPageleave(durationMs: number, reason: string): void;
+//# sourceMappingURL=pageview.d.ts.map

package/dist/analytics/pageview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageview.d.ts","sourceRoot":"","sources":["../../src/analytics/pageview.ts"],"names":[],"mappings":"AAkBA,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ5E"}

package/dist/analytics/pageview.js

@@ -0,0 +1,31 @@
+import { hasPostHogKey } from './config.js';
+import { buildRuntimeProperties } from './events.js';
+import { isAnalyticsEnabled } from './identity.js';
+import { getAnalytics } from './provider.js';
+const MCP_VIRTUAL_URL = 'photoshop-mcp://mcp';
+function capturePageEvent(name, properties) {
+    if (!isAnalyticsEnabled() || !hasPostHogKey())
+        return;
+    getAnalytics().capture({
+        name,
+        properties: buildRuntimeProperties(properties),
+    });
+}
+export function captureMcpPageview() {
+    capturePageEvent('$pageview', {
+        $current_url: MCP_VIRTUAL_URL,
+        $pathname: '/mcp',
+        usage_surface: 'mcp',
+        event_source: 'mcp',
+    });
+}
+export function captureMcpPageleave(durationMs, reason) {
+    capturePageEvent('$pageleave', {
+        $current_url: MCP_VIRTUAL_URL,
+        duration_ms: durationMs,
+        shutdown_reason: reason,
+        usage_surface: 'mcp',
+        event_source: 'mcp',
+    });
+}
+//# sourceMappingURL=pageview.js.map

package/dist/analytics/pageview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageview.js","sourceRoot":"","sources":["../../src/analytics/pageview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAE9C,SAAS,gBAAgB,CACvB,IAAY,EACZ,UAAmC;IAEnC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IACtD,YAAY,EAAE,CAAC,OAAO,CAAC;QACrB,IAAI;QACJ,UAAU,EAAE,sBAAsB,CAAC,UAAU,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,gBAAgB,CAAC,WAAW,EAAE;QAC5B,YAAY,EAAE,eAAe;QAC7B,SAAS,EAAE,MAAM;QACjB,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,MAAc;IACpE,gBAAgB,CAAC,YAAY,EAAE;QAC7B,YAAY,EAAE,eAAe;QAC7B,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,MAAM;QACvB,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/analytics/posthog-node.d.ts

@@ -2,7 +2,10 @@ import type { AnalyticsEvent, AnalyticsProvider } from './types.js';
 export declare class PostHogNodeProvider implements AnalyticsProvider {
     private client;
     private logger;
+    private distinctId;
     constructor();
+    private identifyPerson;
+    identify(properties?: Record<string, unknown>): void;
     capture(event: AnalyticsEvent): void;
     shutdown(): Promise<void>;
 }

package/dist/analytics/posthog-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"posthog-node.d.ts","sourceRoot":"","sources":["../../src/analytics/posthog-node.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpE,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAA2B;;IAUzC,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAY9B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC"}
+{"version":3,"file":"posthog-node.d.ts","sourceRoot":"","sources":["../../src/analytics/posthog-node.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpE,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAS;;IAc3B,OAAO,CAAC,cAAc;IAItB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYpD,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAa9B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC"}