@contractspec/integration.providers-impls 1.57.0 → 1.58.0

package/dist/impls/posthog-utils.js

@@ -1,30 +1,39 @@
-//#region src/impls/posthog-utils.ts
+// @bun
+// src/impls/posthog-utils.ts
 function normalizeHost(host) {
-	return host.replace(/\/$/, "");
+  return host.replace(/\/$/, "");
 }
 function buildUrl(host, path, query) {
-	if (/^https?:\/\//.test(path)) return appendQuery(path, query);
-	return appendQuery(`${host}/${path.replace(/^\/+/, "")}`, query);
+  if (/^https?:\/\//.test(path)) {
+    return appendQuery(path, query);
+  }
+  const normalizedPath = path.replace(/^\/+/, "");
+  return appendQuery(`${host}/${normalizedPath}`, query);
 }
 function appendQuery(url, query) {
-	if (!query) return url;
-	const params = new URLSearchParams();
-	Object.entries(query).forEach(([key, value]) => {
-		if (value === void 0) return;
-		params.set(key, String(value));
-	});
-	const suffix = params.toString();
-	return suffix ? `${url}?${suffix}` : url;
+  if (!query)
+    return url;
+  const params = new URLSearchParams;
+  Object.entries(query).forEach(([key, value]) => {
+    if (value === undefined)
+      return;
+    params.set(key, String(value));
+  });
+  const suffix = params.toString();
+  return suffix ? `${url}?${suffix}` : url;
 }
 function parseJson(value) {
-	if (!value) return {};
-	try {
-		return JSON.parse(value);
-	} catch {
-		return value;
-	}
+  if (!value)
+    return {};
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
 }
-
-//#endregion
-export { appendQuery, buildUrl, normalizeHost, parseJson };
-//# sourceMappingURL=posthog-utils.js.map
+export {
+  parseJson,
+  normalizeHost,
+  buildUrl,
+  appendQuery
+};

package/dist/impls/posthog.d.ts

@@ -1,40 +1,36 @@
-import { analytics_d_exports } from "../analytics.js";
-import { PostHog } from "posthog-node";
-
-//#region src/impls/posthog.d.ts
-interface PosthogAnalyticsProviderOptions {
-  host?: string;
-  projectId?: string | number;
-  projectApiKey?: string;
-  personalApiKey?: string;
-  mcpUrl?: string;
-  requestTimeoutMs?: number;
-  fetch?: typeof fetch;
-  client?: PostHog;
+import { PostHog } from 'posthog-node';
+import type { AnalyticsAnnotation, AnalyticsCohort, AnalyticsEvent, AnalyticsEventInput, AnalyticsFeatureFlag, AnalyticsIdentifyInput, AnalyticsInsight, AnalyticsMcpToolCall, AnalyticsPerson, AnalyticsProvider, AnalyticsQueryInput, AnalyticsQueryResult, AnalyticsRequest, AnalyticsResponse, GetAnnotationsInput, GetCohortsInput, GetEventsInput, GetFeatureFlagsInput, GetInsightResultInput, GetInsightsInput, GetPersonsInput, PaginatedResponse } from '../analytics';
+export interface PosthogAnalyticsProviderOptions {
+    host?: string;
+    projectId?: string | number;
+    projectApiKey?: string;
+    personalApiKey?: string;
+    mcpUrl?: string;
+    requestTimeoutMs?: number;
+    fetch?: typeof fetch;
+    client?: PostHog;
 }
-declare class PosthogAnalyticsProvider implements analytics_d_exports.AnalyticsProvider {
-  private readonly host;
-  private readonly projectId?;
-  private readonly projectApiKey?;
-  private readonly personalApiKey?;
-  private readonly mcpUrl?;
-  private readonly fetchFn;
-  private readonly client?;
-  private readonly reader;
-  constructor(options: PosthogAnalyticsProviderOptions);
-  capture(event: analytics_d_exports.AnalyticsEventInput): Promise<void>;
-  identify(input: analytics_d_exports.AnalyticsIdentifyInput): Promise<void>;
-  queryHogQL(input: analytics_d_exports.AnalyticsQueryInput): Promise<analytics_d_exports.AnalyticsQueryResult>;
-  getEvents(input: analytics_d_exports.GetEventsInput): Promise<analytics_d_exports.PaginatedResponse<analytics_d_exports.AnalyticsEvent>>;
-  getPersons(input: analytics_d_exports.GetPersonsInput): Promise<analytics_d_exports.PaginatedResponse<analytics_d_exports.AnalyticsPerson>>;
-  getInsights(input: analytics_d_exports.GetInsightsInput): Promise<analytics_d_exports.PaginatedResponse<analytics_d_exports.AnalyticsInsight>>;
-  getInsightResult(input: analytics_d_exports.GetInsightResultInput): Promise<analytics_d_exports.AnalyticsInsight>;
-  getCohorts(input: analytics_d_exports.GetCohortsInput): Promise<analytics_d_exports.PaginatedResponse<analytics_d_exports.AnalyticsCohort>>;
-  getFeatureFlags(input: analytics_d_exports.GetFeatureFlagsInput): Promise<analytics_d_exports.PaginatedResponse<analytics_d_exports.AnalyticsFeatureFlag>>;
-  getAnnotations(input: analytics_d_exports.GetAnnotationsInput): Promise<analytics_d_exports.PaginatedResponse<analytics_d_exports.AnalyticsAnnotation>>;
-  request<T = unknown>(request: analytics_d_exports.AnalyticsRequest): Promise<analytics_d_exports.AnalyticsResponse<T>>;
-  callMcpTool(call: analytics_d_exports.AnalyticsMcpToolCall): Promise<unknown>;
+export declare class PosthogAnalyticsProvider implements AnalyticsProvider {
+    private readonly host;
+    private readonly projectId?;
+    private readonly projectApiKey?;
+    private readonly personalApiKey?;
+    private readonly mcpUrl?;
+    private readonly fetchFn;
+    private readonly client?;
+    private readonly reader;
+    constructor(options: PosthogAnalyticsProviderOptions);
+    capture(event: AnalyticsEventInput): Promise<void>;
+    identify(input: AnalyticsIdentifyInput): Promise<void>;
+    queryHogQL(input: AnalyticsQueryInput): Promise<AnalyticsQueryResult>;
+    getEvents(input: GetEventsInput): Promise<PaginatedResponse<AnalyticsEvent>>;
+    getPersons(input: GetPersonsInput): Promise<PaginatedResponse<AnalyticsPerson>>;
+    getInsights(input: GetInsightsInput): Promise<PaginatedResponse<AnalyticsInsight>>;
+    getInsightResult(input: GetInsightResultInput): Promise<AnalyticsInsight>;
+    getCohorts(input: GetCohortsInput): Promise<PaginatedResponse<AnalyticsCohort>>;
+    getFeatureFlags(input: GetFeatureFlagsInput): Promise<PaginatedResponse<AnalyticsFeatureFlag>>;
+    getAnnotations(input: GetAnnotationsInput): Promise<PaginatedResponse<AnalyticsAnnotation>>;
+    request<T = unknown>(request: AnalyticsRequest): Promise<AnalyticsResponse<T>>;
+    callMcpTool(call: AnalyticsMcpToolCall): Promise<unknown>;
 }
-//#endregion
-export { PosthogAnalyticsProvider, PosthogAnalyticsProviderOptions };
 //# sourceMappingURL=posthog.d.ts.map

package/dist/impls/posthog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"posthog.d.ts","names":[],"sources":["../../src/impls/posthog.ts"],"mappings":";;;;UA4BiB,+BAAA;EACf,IAAA;EACA,SAAA;EACA,aAAA;EACA,cAAA;EACA,MAAA;EACA,gBAAA;EACA,KAAA,UAAe,KAAA;EACf,MAAA,GAAS,OAAA;AAAA;AAAA,cAKE,wBAAA,YAAoC,mBAAA,CAAA,iBAAA;EAAA,iBAC9B,IAAA;EAAA,iBACA,SAAA;EAAA,iBACA,aAAA;EAAA,iBACA,cAAA;EAAA,iBACA,MAAA;EAAA,iBACA,OAAA;EAAA,iBACA,MAAA;EAAA,iBACA,MAAA;cAEL,OAAA,EAAS,+BAAA;EAqBf,OAAA,CAAQ,KAAA,EAAO,mBAAA,CAAA,mBAAA,GAAsB,OAAA;EAarC,QAAA,CAAS,KAAA,EAAO,mBAAA,CAAA,sBAAA,GAAyB,OAAA;EAazC,UAAA,CAAW,KAAA,EAAO,mBAAA,CAAA,mBAAA,GAAsB,OAAA,CAAQ,mBAAA,CAAA,oBAAA;EAIhD,SAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,cAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,cAAA;EAIvB,UAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,eAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,eAAA;EAIvB,WAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,gBAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,gBAAA;EAIvB,gBAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,qBAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,gBAAA;EAIL,UAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,eAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,eAAA;EAIvB,eAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,oBAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,oBAAA;EAIvB,cAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,mBAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,mBAAA;EAIvB,OAAA,aAAA,CACJ,OAAA,EAAS,mBAAA,CAAA,gBAAA,GACR,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,CAAA;EAwBvB,WAAA,CAAY,IAAA,EAAM,mBAAA,CAAA,oBAAA,GAAuB,OAAA;AAAA"}
+{"version":3,"file":"posthog.d.ts","sourceRoot":"","sources":["../../src/impls/posthog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,+BAA+B;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAEpC,OAAO,EAAE,+BAA+B;IAqB9C,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAalD,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIrE,SAAS,CACb,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAIvC,UAAU,CACd,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAIxC,WAAW,CACf,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAIzC,gBAAgB,CACpB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC;IAItB,UAAU,CACd,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAIxC,eAAe,CACnB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;IAI7C,cAAc,CAClB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IAI5C,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAwB1B,WAAW,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;CAiChE"}

package/dist/impls/posthog.js

@@ -1,122 +1,323 @@
-import { PosthogAnalyticsReader } from "./posthog-reader.js";
-import { buildUrl, normalizeHost, parseJson } from "./posthog-utils.js";
+// @bun
+// src/impls/posthog-reader.ts
+class PosthogAnalyticsReader {
+  projectId;
+  client;
+  constructor(options) {
+    this.projectId = options.projectId;
+    this.client = options.client;
+  }
+  async queryHogQL(input) {
+    const projectId = resolveProjectId(undefined, this.projectId);
+    const response = await this.client.request({
+      method: "POST",
+      path: `/api/projects/${projectId}/query`,
+      body: {
+        query: {
+          kind: "HogQLQuery",
+          query: input.query,
+          values: input.values
+        }
+      }
+    });
+    return response.data;
+  }
+  async getEvents(input) {
+    const projectId = resolveProjectId(input.projectId, this.projectId);
+    const response = await this.client.request({
+      method: "GET",
+      path: `/api/projects/${projectId}/events/`,
+      query: {
+        event: input.event ?? resolveSingleEvent(input.events),
+        events: resolveEventList(input.events),
+        distinct_id: input.distinctId,
+        order_by: input.orderBy,
+        limit: input.limit,
+        offset: input.offset,
+        properties: input.properties ? JSON.stringify(input.properties) : undefined,
+        ...buildEventDateQuery(input.dateRange)
+      }
+    });
+    return response.data;
+  }
+  async getPersons(input) {
+    const projectId = resolveProjectId(input.projectId, this.projectId);
+    const response = await this.client.request({
+      method: "GET",
+      path: `/api/projects/${projectId}/persons/`,
+      query: {
+        cohort_id: input.cohortId,
+        search: input.search,
+        limit: input.limit,
+        offset: input.offset,
+        properties: input.properties ? JSON.stringify(input.properties) : undefined
+      }
+    });
+    return response.data;
+  }
+  async getInsights(input) {
+    const projectId = resolveProjectId(input.projectId, this.projectId);
+    const response = await this.client.request({
+      method: "GET",
+      path: `/api/projects/${projectId}/insights/`,
+      query: {
+        insight: input.insightType,
+        limit: input.limit,
+        offset: input.offset
+      }
+    });
+    return response.data;
+  }
+  async getInsightResult(input) {
+    const projectId = resolveProjectId(input.projectId, this.projectId);
+    const response = await this.client.request({
+      method: "GET",
+      path: `/api/projects/${projectId}/insights/${input.insightId}/`
+    });
+    return response.data;
+  }
+  async getCohorts(input) {
+    const projectId = resolveProjectId(input.projectId, this.projectId);
+    const response = await this.client.request({
+      method: "GET",
+      path: `/api/projects/${projectId}/cohorts/`,
+      query: {
+        limit: input.limit,
+        offset: input.offset
+      }
+    });
+    return response.data;
+  }
+  async getFeatureFlags(input) {
+    const projectId = resolveProjectId(input.projectId, this.projectId);
+    const response = await this.client.request({
+      method: "GET",
+      path: `/api/projects/${projectId}/feature_flags/`,
+      query: {
+        active: input.active,
+        limit: input.limit,
+        offset: input.offset
+      }
+    });
+    return response.data;
+  }
+  async getAnnotations(input) {
+    const projectId = resolveProjectId(input.projectId, this.projectId);
+    const response = await this.client.request({
+      method: "GET",
+      path: `/api/projects/${projectId}/annotations/`,
+      query: {
+        limit: input.limit,
+        offset: input.offset,
+        ...buildAnnotationDateQuery(input.dateRange)
+      }
+    });
+    return response.data;
+  }
+}
+function resolveProjectId(inputProjectId, defaultProjectId) {
+  const projectId = inputProjectId ?? defaultProjectId;
+  if (!projectId) {
+    throw new Error("PostHog projectId is required for API reads.");
+  }
+  return projectId;
+}
+function resolveSingleEvent(events) {
+  if (!events || events.length !== 1)
+    return;
+  return events[0];
+}
+function resolveEventList(events) {
+  if (!events || events.length <= 1)
+    return;
+  return events.join(",");
+}
+function buildEventDateQuery(range) {
+  const after = formatDate(range?.from);
+  const before = formatDate(range?.to);
+  return {
+    after,
+    before,
+    timezone: range?.timezone
+  };
+}
+function buildAnnotationDateQuery(range) {
+  const dateFrom = formatDate(range?.from);
+  const dateTo = formatDate(range?.to);
+  return {
+    date_from: dateFrom,
+    date_to: dateTo,
+    timezone: range?.timezone
+  };
+}
+function formatDate(value) {
+  if (!value)
+    return;
+  return typeof value === "string" ? value : value.toISOString();
+}
+
+// src/impls/posthog-utils.ts
+function normalizeHost(host) {
+  return host.replace(/\/$/, "");
+}
+function buildUrl(host, path, query) {
+  if (/^https?:\/\//.test(path)) {
+    return appendQuery(path, query);
+  }
+  const normalizedPath = path.replace(/^\/+/, "");
+  return appendQuery(`${host}/${normalizedPath}`, query);
+}
+function appendQuery(url, query) {
+  if (!query)
+    return url;
+  const params = new URLSearchParams;
+  Object.entries(query).forEach(([key, value]) => {
+    if (value === undefined)
+      return;
+    params.set(key, String(value));
+  });
+  const suffix = params.toString();
+  return suffix ? `${url}?${suffix}` : url;
+}
+function parseJson(value) {
+  if (!value)
+    return {};
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+
+// src/impls/posthog.ts
 import { PostHog } from "posthog-node";
+var DEFAULT_POSTHOG_HOST = "https://app.posthog.com";
 
-//#region src/impls/posthog.ts
-const DEFAULT_POSTHOG_HOST = "https://app.posthog.com";
-var PosthogAnalyticsProvider = class {
-	host;
-	projectId;
-	projectApiKey;
-	personalApiKey;
-	mcpUrl;
-	fetchFn;
-	client;
-	reader;
-	constructor(options) {
-		this.host = normalizeHost(options.host ?? DEFAULT_POSTHOG_HOST);
-		this.projectId = options.projectId;
-		this.projectApiKey = options.projectApiKey;
-		this.personalApiKey = options.personalApiKey;
-		this.mcpUrl = options.mcpUrl;
-		this.fetchFn = options.fetch ?? fetch;
-		this.client = options.client ?? (options.projectApiKey ? new PostHog(options.projectApiKey, {
-			host: this.host,
-			requestTimeout: options.requestTimeoutMs ?? 1e4
-		}) : void 0);
-		this.reader = new PosthogAnalyticsReader({
-			projectId: this.projectId,
-			client: { request: this.request.bind(this) }
-		});
-	}
-	async capture(event) {
-		if (!this.client) throw new Error("PostHog projectApiKey is required for capture.");
-		await this.client.capture({
-			distinctId: event.distinctId,
-			event: event.event,
-			properties: event.properties,
-			timestamp: event.timestamp,
-			groups: event.groups
-		});
-	}
-	async identify(input) {
-		if (!this.client) throw new Error("PostHog projectApiKey is required for identify.");
-		await this.client.identify({
-			distinctId: input.distinctId,
-			properties: {
-				...input.properties ? { $set: input.properties } : {},
-				...input.setOnce ? { $set_once: input.setOnce } : {}
-			}
-		});
-	}
-	async queryHogQL(input) {
-		return this.reader.queryHogQL(input);
-	}
-	async getEvents(input) {
-		return this.reader.getEvents(input);
-	}
-	async getPersons(input) {
-		return this.reader.getPersons(input);
-	}
-	async getInsights(input) {
-		return this.reader.getInsights(input);
-	}
-	async getInsightResult(input) {
-		return this.reader.getInsightResult(input);
-	}
-	async getCohorts(input) {
-		return this.reader.getCohorts(input);
-	}
-	async getFeatureFlags(input) {
-		return this.reader.getFeatureFlags(input);
-	}
-	async getAnnotations(input) {
-		return this.reader.getAnnotations(input);
-	}
-	async request(request) {
-		if (!this.personalApiKey) throw new Error("PostHog personalApiKey is required for API requests.");
-		const url = buildUrl(this.host, request.path, request.query);
-		const response = await this.fetchFn(url, {
-			method: request.method,
-			headers: {
-				Authorization: `Bearer ${this.personalApiKey}`,
-				"Content-Type": "application/json",
-				...request.headers ?? {}
-			},
-			body: request.body ? JSON.stringify(request.body) : void 0
-		});
-		const data = parseJson(await response.text());
-		return {
-			status: response.status,
-			data,
-			headers: Object.fromEntries(response.headers.entries())
-		};
-	}
-	async callMcpTool(call) {
-		if (!this.mcpUrl) throw new Error("PostHog MCP URL is not configured.");
-		const response = await this.fetchFn(this.mcpUrl, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify({
-				jsonrpc: "2.0",
-				id: 1,
-				method: "tools/call",
-				params: {
-					name: call.name,
-					arguments: call.arguments ?? {}
-				}
-			})
-		});
-		if (!response.ok) {
-			const body = await response.text();
-			throw new Error(`PostHog MCP error (${response.status}): ${body}`);
-		}
-		const result = await response.json();
-		if (result.error) throw new Error(result.error.message ?? "PostHog MCP error");
-		return result.result ?? null;
-	}
+class PosthogAnalyticsProvider {
+  host;
+  projectId;
+  projectApiKey;
+  personalApiKey;
+  mcpUrl;
+  fetchFn;
+  client;
+  reader;
+  constructor(options) {
+    this.host = normalizeHost(options.host ?? DEFAULT_POSTHOG_HOST);
+    this.projectId = options.projectId;
+    this.projectApiKey = options.projectApiKey;
+    this.personalApiKey = options.personalApiKey;
+    this.mcpUrl = options.mcpUrl;
+    this.fetchFn = options.fetch ?? fetch;
+    this.client = options.client ?? (options.projectApiKey ? new PostHog(options.projectApiKey, {
+      host: this.host,
+      requestTimeout: options.requestTimeoutMs ?? 1e4
+    }) : undefined);
+    this.reader = new PosthogAnalyticsReader({
+      projectId: this.projectId,
+      client: { request: this.request.bind(this) }
+    });
+  }
+  async capture(event) {
+    if (!this.client) {
+      throw new Error("PostHog projectApiKey is required for capture.");
+    }
+    await this.client.capture({
+      distinctId: event.distinctId,
+      event: event.event,
+      properties: event.properties,
+      timestamp: event.timestamp,
+      groups: event.groups
+    });
+  }
+  async identify(input) {
+    if (!this.client) {
+      throw new Error("PostHog projectApiKey is required for identify.");
+    }
+    await this.client.identify({
+      distinctId: input.distinctId,
+      properties: {
+        ...input.properties ? { $set: input.properties } : {},
+        ...input.setOnce ? { $set_once: input.setOnce } : {}
+      }
+    });
+  }
+  async queryHogQL(input) {
+    return this.reader.queryHogQL(input);
+  }
+  async getEvents(input) {
+    return this.reader.getEvents(input);
+  }
+  async getPersons(input) {
+    return this.reader.getPersons(input);
+  }
+  async getInsights(input) {
+    return this.reader.getInsights(input);
+  }
+  async getInsightResult(input) {
+    return this.reader.getInsightResult(input);
+  }
+  async getCohorts(input) {
+    return this.reader.getCohorts(input);
+  }
+  async getFeatureFlags(input) {
+    return this.reader.getFeatureFlags(input);
+  }
+  async getAnnotations(input) {
+    return this.reader.getAnnotations(input);
+  }
+  async request(request) {
+    if (!this.personalApiKey) {
+      throw new Error("PostHog personalApiKey is required for API requests.");
+    }
+    const url = buildUrl(this.host, request.path, request.query);
+    const response = await this.fetchFn(url, {
+      method: request.method,
+      headers: {
+        Authorization: `Bearer ${this.personalApiKey}`,
+        "Content-Type": "application/json",
+        ...request.headers ?? {}
+      },
+      body: request.body ? JSON.stringify(request.body) : undefined
+    });
+    const text = await response.text();
+    const data = parseJson(text);
+    return {
+      status: response.status,
+      data,
+      headers: Object.fromEntries(response.headers.entries())
+    };
+  }
+  async callMcpTool(call) {
+    if (!this.mcpUrl) {
+      throw new Error("PostHog MCP URL is not configured.");
+    }
+    const response = await this.fetchFn(this.mcpUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/call",
+        params: {
+          name: call.name,
+          arguments: call.arguments ?? {}
+        }
+      })
+    });
+    if (!response.ok) {
+      const body = await response.text();
+      throw new Error(`PostHog MCP error (${response.status}): ${body}`);
+    }
+    const result = await response.json();
+    if (result.error) {
+      throw new Error(result.error.message ?? "PostHog MCP error");
+    }
+    return result.result ?? null;
+  }
+}
+export {
+  PosthogAnalyticsProvider
 };
-
-//#endregion
-export { PosthogAnalyticsProvider };
-//# sourceMappingURL=posthog.js.map

package/dist/impls/postmark-email.d.ts

@@ -1,20 +1,16 @@
-import { email_d_exports } from "../email.js";
-import { ServerClient } from "postmark";
-
-//#region src/impls/postmark-email.d.ts
-interface PostmarkEmailProviderOptions {
-  serverToken: string;
-  defaultFromEmail?: string;
-  messageStream?: string;
-  client?: ServerClient;
+import { ServerClient } from 'postmark';
+import type { EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult } from '../email';
+export interface PostmarkEmailProviderOptions {
+    serverToken: string;
+    defaultFromEmail?: string;
+    messageStream?: string;
+    client?: ServerClient;
 }
-declare class PostmarkEmailProvider implements email_d_exports.EmailOutboundProvider {
-  private readonly client;
-  private readonly defaultFromEmail?;
-  private readonly messageStream?;
-  constructor(options: PostmarkEmailProviderOptions);
-  sendEmail(message: email_d_exports.EmailOutboundMessage): Promise<email_d_exports.EmailOutboundResult>;
+export declare class PostmarkEmailProvider implements EmailOutboundProvider {
+    private readonly client;
+    private readonly defaultFromEmail?;
+    private readonly messageStream?;
+    constructor(options: PostmarkEmailProviderOptions);
+    sendEmail(message: EmailOutboundMessage): Promise<EmailOutboundResult>;
 }
-//#endregion
-export { PostmarkEmailProvider, PostmarkEmailProviderOptions };
 //# sourceMappingURL=postmark-email.d.ts.map

package/dist/impls/postmark-email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postmark-email.d.ts","names":[],"sources":["../../src/impls/postmark-email.ts"],"mappings":";;;;UAQiB,4BAAA;EACf,WAAA;EACA,gBAAA;EACA,aAAA;EACA,MAAA,GAAS,YAAA;AAAA;AAAA,cAGE,qBAAA,YAAiC,eAAA,CAAA,qBAAA;EAAA,iBAC3B,MAAA;EAAA,iBACA,gBAAA;EAAA,iBACA,aAAA;cAEL,OAAA,EAAS,4BAAA;EAUf,SAAA,CAAU,OAAA,EAAS,eAAA,CAAA,oBAAA,GAAuB,OAAA,CAAQ,eAAA,CAAA,mBAAA;AAAA"}
+{"version":3,"file":"postmark-email.d.ts","sourceRoot":"","sources":["../../src/impls/postmark-email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiC,MAAM,UAAU,CAAC;AAEvE,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,qBAAa,qBAAsB,YAAW,qBAAqB;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,OAAO,EAAE,4BAA4B;IAU3C,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA6B7E"}