@contractspec/integration.providers-impls 1.56.0 → 1.57.0

package/dist/impls/linear.d.ts

@@ -0,0 +1,24 @@
+import { project_management_d_exports } from "../project-management.js";
+import { LinearClient } from "@linear/sdk";
+
+//#region src/impls/linear.d.ts
+interface LinearProjectManagementProviderOptions {
+  apiKey: string;
+  teamId?: string;
+  projectId?: string;
+  assigneeId?: string;
+  stateId?: string;
+  labelIds?: string[];
+  tagLabelMap?: Record<string, string>;
+  client?: LinearClient;
+}
+declare class LinearProjectManagementProvider implements project_management_d_exports.ProjectManagementProvider {
+  private readonly client;
+  private readonly defaults;
+  constructor(options: LinearProjectManagementProviderOptions);
+  createWorkItem(input: project_management_d_exports.ProjectManagementWorkItemInput): Promise<project_management_d_exports.ProjectManagementWorkItem>;
+  createWorkItems(items: project_management_d_exports.ProjectManagementWorkItemInput[]): Promise<project_management_d_exports.ProjectManagementWorkItem[]>;
+}
+//#endregion
+export { LinearProjectManagementProvider, LinearProjectManagementProviderOptions };
+//# sourceMappingURL=linear.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","names":[],"sources":["../../src/impls/linear.ts"],"mappings":";;;;UAQiB,sCAAA;EACf,MAAA;EACA,MAAA;EACA,SAAA;EACA,UAAA;EACA,OAAA;EACA,QAAA;EACA,WAAA,GAAc,MAAA;EACd,MAAA,GAAS,YAAA;AAAA;AAAA,cAWE,+BAAA,YAA2C,4BAAA,CAAA,yBAAA;EAAA,iBACrC,MAAA;EAAA,iBACA,QAAA;cAKL,OAAA,EAAS,sCAAA;EAaf,cAAA,CACJ,KAAA,EAAO,4BAAA,CAAA,8BAAA,GACN,OAAA,CAAQ,4BAAA,CAAA,yBAAA;EAiCL,eAAA,CACJ,KAAA,EAAO,4BAAA,CAAA,8BAAA,KACN,OAAA,CAAQ,4BAAA,CAAA,yBAAA;AAAA"}

package/dist/impls/linear.js

@@ -0,0 +1,75 @@
+import { LinearClient } from "@linear/sdk";
+
+//#region src/impls/linear.ts
+const PRIORITY_MAP = {
+	urgent: 1,
+	high: 2,
+	medium: 3,
+	low: 4,
+	none: 0
+};
+var LinearProjectManagementProvider = class {
+	client;
+	defaults;
+	constructor(options) {
+		this.client = options.client ?? new LinearClient({ apiKey: options.apiKey });
+		this.defaults = {
+			teamId: options.teamId,
+			projectId: options.projectId,
+			assigneeId: options.assigneeId,
+			stateId: options.stateId,
+			labelIds: options.labelIds,
+			tagLabelMap: options.tagLabelMap
+		};
+	}
+	async createWorkItem(input) {
+		const teamId = this.defaults.teamId;
+		if (!teamId) throw new Error("Linear teamId is required to create work items.");
+		const issue = await (await this.client.createIssue({
+			teamId,
+			title: input.title,
+			description: input.description,
+			priority: mapPriority(input.priority),
+			estimate: input.estimate,
+			assigneeId: input.assigneeId ?? this.defaults.assigneeId,
+			projectId: input.projectId ?? this.defaults.projectId,
+			stateId: this.defaults.stateId,
+			labelIds: resolveLabelIds(this.defaults, input.tags)
+		})).issue;
+		const state = issue ? await issue.state : void 0;
+		return {
+			id: issue?.id ?? "",
+			title: issue?.title ?? input.title,
+			url: issue?.url ?? void 0,
+			status: state?.name ?? void 0,
+			priority: input.priority,
+			tags: input.tags,
+			projectId: input.projectId ?? this.defaults.projectId,
+			externalId: input.externalId,
+			metadata: input.metadata
+		};
+	}
+	async createWorkItems(items) {
+		const created = [];
+		for (const item of items) created.push(await this.createWorkItem(item));
+		return created;
+	}
+};
+function mapPriority(priority) {
+	if (!priority) return void 0;
+	return PRIORITY_MAP[priority] ?? void 0;
+}
+function resolveLabelIds(defaults, tags) {
+	const labelIds = /* @__PURE__ */ new Set();
+	(defaults.labelIds ?? []).forEach((id) => labelIds.add(id));
+	if (tags && defaults.tagLabelMap) tags.forEach((tag) => {
+		const mapped = defaults.tagLabelMap?.[tag];
+		if (mapped) labelIds.add(mapped);
+	});
+	const merged = [...labelIds];
+	return merged.length > 0 ? merged : void 0;
+}
+
+//#endregion
+export { LinearProjectManagementProvider };
+//# sourceMappingURL=linear.js.map

package/dist/impls/linear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.js","names":[],"sources":["../../src/impls/linear.ts"],"sourcesContent":["import { LinearClient } from '@linear/sdk';\nimport type {\n  ProjectManagementProvider,\n  ProjectManagementWorkItem,\n  ProjectManagementWorkItemInput,\n  ProjectManagementWorkItemPriority,\n} from '../project-management';\n\nexport interface LinearProjectManagementProviderOptions {\n  apiKey: string;\n  teamId?: string;\n  projectId?: string;\n  assigneeId?: string;\n  stateId?: string;\n  labelIds?: string[];\n  tagLabelMap?: Record<string, string>;\n  client?: LinearClient;\n}\n\nconst PRIORITY_MAP: Record<ProjectManagementWorkItemPriority, number> = {\n  urgent: 1,\n  high: 2,\n  medium: 3,\n  low: 4,\n  none: 0,\n};\n\nexport class LinearProjectManagementProvider implements ProjectManagementProvider {\n  private readonly client: LinearClient;\n  private readonly defaults: Omit<\n    LinearProjectManagementProviderOptions,\n    'apiKey' | 'client'\n  >;\n\n  constructor(options: LinearProjectManagementProviderOptions) {\n    this.client =\n      options.client ?? new LinearClient({ apiKey: options.apiKey });\n    this.defaults = {\n      teamId: options.teamId,\n      projectId: options.projectId,\n      assigneeId: options.assigneeId,\n      stateId: options.stateId,\n      labelIds: options.labelIds,\n      tagLabelMap: options.tagLabelMap,\n    };\n  }\n\n  async createWorkItem(\n    input: ProjectManagementWorkItemInput\n  ): Promise<ProjectManagementWorkItem> {\n    const teamId = this.defaults.teamId;\n    if (!teamId) {\n      throw new Error('Linear teamId is required to create work items.');\n    }\n\n    const payload = await this.client.createIssue({\n      teamId,\n      title: input.title,\n      description: input.description,\n      priority: mapPriority(input.priority),\n      estimate: input.estimate,\n      assigneeId: input.assigneeId ?? this.defaults.assigneeId,\n      projectId: input.projectId ?? this.defaults.projectId,\n      stateId: this.defaults.stateId,\n      labelIds: resolveLabelIds(this.defaults, input.tags),\n    });\n\n    const issue = await payload.issue;\n    const state = issue ? await issue.state : undefined;\n    return {\n      id: issue?.id ?? '',\n      title: issue?.title ?? input.title,\n      url: issue?.url ?? undefined,\n      status: state?.name ?? undefined,\n      priority: input.priority,\n      tags: input.tags,\n      projectId: input.projectId ?? this.defaults.projectId,\n      externalId: input.externalId,\n      metadata: input.metadata,\n    };\n  }\n\n  async createWorkItems(\n    items: ProjectManagementWorkItemInput[]\n  ): Promise<ProjectManagementWorkItem[]> {\n    const created: ProjectManagementWorkItem[] = [];\n    for (const item of items) {\n      created.push(await this.createWorkItem(item));\n    }\n    return created;\n  }\n}\n\nfunction mapPriority(\n  priority?: ProjectManagementWorkItemPriority\n): number | undefined {\n  if (!priority) return undefined;\n  return PRIORITY_MAP[priority] ?? undefined;\n}\n\nfunction resolveLabelIds(\n  defaults: Pick<\n    LinearProjectManagementProviderOptions,\n    'labelIds' | 'tagLabelMap'\n  >,\n  tags?: string[]\n): string[] | undefined {\n  const labelIds = new Set<string>();\n  (defaults.labelIds ?? []).forEach((id) => labelIds.add(id));\n  if (tags && defaults.tagLabelMap) {\n    tags.forEach((tag) => {\n      const mapped = defaults.tagLabelMap?.[tag];\n      if (mapped) labelIds.add(mapped);\n    });\n  }\n  const merged = [...labelIds];\n  return merged.length > 0 ? merged : undefined;\n}\n"],"mappings":";;;AAmBA,MAAM,eAAkE;CACtE,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,KAAK;CACL,MAAM;CACP;AAED,IAAa,kCAAb,MAAkF;CAChF,AAAiB;CACjB,AAAiB;CAKjB,YAAY,SAAiD;AAC3D,OAAK,SACH,QAAQ,UAAU,IAAI,aAAa,EAAE,QAAQ,QAAQ,QAAQ,CAAC;AAChE,OAAK,WAAW;GACd,QAAQ,QAAQ;GAChB,WAAW,QAAQ;GACnB,YAAY,QAAQ;GACpB,SAAS,QAAQ;GACjB,UAAU,QAAQ;GAClB,aAAa,QAAQ;GACtB;;CAGH,MAAM,eACJ,OACoC;EACpC,MAAM,SAAS,KAAK,SAAS;AAC7B,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,kDAAkD;EAepE,MAAM,QAAQ,OAZE,MAAM,KAAK,OAAO,YAAY;GAC5C;GACA,OAAO,MAAM;GACb,aAAa,MAAM;GACnB,UAAU,YAAY,MAAM,SAAS;GACrC,UAAU,MAAM;GAChB,YAAY,MAAM,cAAc,KAAK,SAAS;GAC9C,WAAW,MAAM,aAAa,KAAK,SAAS;GAC5C,SAAS,KAAK,SAAS;GACvB,UAAU,gBAAgB,KAAK,UAAU,MAAM,KAAK;GACrD,CAAC,EAE0B;EAC5B,MAAM,QAAQ,QAAQ,MAAM,MAAM,QAAQ;AAC1C,SAAO;GACL,IAAI,OAAO,MAAM;GACjB,OAAO,OAAO,SAAS,MAAM;GAC7B,KAAK,OAAO,OAAO;GACnB,QAAQ,OAAO,QAAQ;GACvB,UAAU,MAAM;GAChB,MAAM,MAAM;GACZ,WAAW,MAAM,aAAa,KAAK,SAAS;GAC5C,YAAY,MAAM;GAClB,UAAU,MAAM;GACjB;;CAGH,MAAM,gBACJ,OACsC;EACtC,MAAM,UAAuC,EAAE;AAC/C,OAAK,MAAM,QAAQ,MACjB,SAAQ,KAAK,MAAM,KAAK,eAAe,KAAK,CAAC;AAE/C,SAAO;;;AAIX,SAAS,YACP,UACoB;AACpB,KAAI,CAAC,SAAU,QAAO;AACtB,QAAO,aAAa,aAAa;;AAGnC,SAAS,gBACP,UAIA,MACsB;CACtB,MAAM,2BAAW,IAAI,KAAa;AAClC,EAAC,SAAS,YAAY,EAAE,EAAE,SAAS,OAAO,SAAS,IAAI,GAAG,CAAC;AAC3D,KAAI,QAAQ,SAAS,YACnB,MAAK,SAAS,QAAQ;EACpB,MAAM,SAAS,SAAS,cAAc;AACtC,MAAI,OAAQ,UAAS,IAAI,OAAO;GAChC;CAEJ,MAAM,SAAS,CAAC,GAAG,SAAS;AAC5B,QAAO,OAAO,SAAS,IAAI,SAAS"}

package/dist/impls/mistral-embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mistral-embedding.d.ts","names":[],"sources":["../../src/impls/mistral-embedding.ts"],"sourcesContent":[],"mappings":";;;;UAQiB,+BAAA;;EAAA,YAAA,CAAA,EAAA,MAAA;EAOJ,SAAA,CAAA,EAAA,MAAA;EAIU,MAAA,CAAA,EAPZ,OAOY;;AAiBV,cArBA,wBAAA,YAAoC,mBAAA,CAAA,iBAqBpC,CAAA;EAAR,iBAAA,MAAA;EA4BQ,iBAAA,YAAA;EAAR,WAAA,CAAA,OAAA,EA7CkB,+BA6ClB;EAjD4C,cAAA,CAAA,SAAA,EAmBlC,mBAAA,CAAA,iBAnBkC,EAAA,EAAA,QAAA,EAAA;IAAiB,KAAA,CAAA,EAAA,MAAA;MAqB7D,QAAQ,mBAAA,CAAA;;;MA4BR,QAAQ,mBAAA,CAAA"}
+{"version":3,"file":"mistral-embedding.d.ts","names":[],"sources":["../../src/impls/mistral-embedding.ts"],"mappings":";;;;UAQiB,+BAAA;EACf,MAAA;EACA,YAAA;EACA,SAAA;EACA,MAAA,GAAS,OAAA;AAAA;AAAA,cAGE,wBAAA,YAAoC,mBAAA,CAAA,iBAAA;EAAA,iBAC9B,MAAA;EAAA,iBACA,YAAA;cAEL,OAAA,EAAS,+BAAA;EAcf,cAAA,CACJ,SAAA,EAAW,mBAAA,CAAA,iBAAA,IACX,OAAA;IAAY,KAAA;EAAA,IACX,OAAA,CAAQ,mBAAA,CAAA,eAAA;EAyBL,UAAA,CACJ,KAAA,UACA,OAAA;IAAY,KAAA;EAAA,IACX,OAAA,CAAQ,mBAAA,CAAA,eAAA;AAAA"}

package/dist/impls/mistral-llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mistral-llm.d.ts","names":[],"sources":["../../src/impls/mistral-llm.ts"],"sourcesContent":[],"mappings":";;;;UAciB,yBAAA;;EAAA,YAAA,CAAA,EAAA,MAAA;EAQJ,SAAA,CAAA,EAAA,MAAA;EAIU,MAAA,CAAA,EARZ,OAQY;EAkBT,eAAA,CAAA,EAAA,MAAA;;AAED,cAxBA,kBAAA,YAA8B,aAAA,CAAA,WAwB9B,CAAA;EAAR,iBAAA,MAAA;EAOS,iBAAA,YAAA;EACD,WAAA,CAAA,OAAA,EA5BU,yBA4BV;EACM,IAAA,CAAA,QAAA,EAXL,aAAA,CAAA,UAWK,EAAA,EAAA,OAAA,CAAA,EAVN,aAAA,CAAA,cAUM,CAAA,EATd,OASc,CATN,aAAA,CAAA,WASM,CAAA;EAAd,MAAA,CAAA,QAAA,EAFS,aAAA,CAAA,UAET,EAAA,EAAA,OAAA,CAAA,EADQ,aAAA,CAAA,cACR,CAAA,EAAA,aAAA,CAAc,aAAA,CAAA,cAAd,CAAA;EAuFU,WAAA,CAAA,SAAA,EAAA,aAAA,CAAA,UAAA,EAAA,CAAA,EACV,OADU,CAAA;IACV,YAAA,EAAA,MAAA;EAzHsC,CAAA,CAAA;EAAW,QAAA,gBAAA"}
+{"version":3,"file":"mistral-llm.d.ts","names":[],"sources":["../../src/impls/mistral-llm.ts"],"mappings":";;;;UAciB,yBAAA;EACf,MAAA;EACA,YAAA;EACA,SAAA;EACA,MAAA,GAAS,OAAA;EACT,eAAA;AAAA;AAAA,cAGW,kBAAA,YAA8B,aAAA,CAAA,WAAA;EAAA,iBACxB,MAAA;EAAA,iBACA,YAAA;cAEL,OAAA,EAAS,yBAAA;EAiBf,IAAA,CACJ,QAAA,EAAU,aAAA,CAAA,UAAA,IACV,OAAA,GAAS,aAAA,CAAA,cAAA,GACR,OAAA,CAAQ,aAAA,CAAA,WAAA;EAMJ,MAAA,CACL,QAAA,EAAU,aAAA,CAAA,UAAA,IACV,OAAA,GAAS,aAAA,CAAA,cAAA,GACR,aAAA,CAAc,aAAA,CAAA,cAAA;EAsFX,WAAA,CACJ,SAAA,EAAW,aAAA,CAAA,UAAA,KACV,OAAA;IAAU,YAAA;EAAA;EAAA,QAIL,gBAAA;EAAA,QAiDA,gBAAA;EAAA,QAuBA,SAAA;EAAA,QAWA,oBAAA;EAAA,QAiCA,mBAAA;EAAA,QAgBA,gBAAA;EAAA,QAmCA,WAAA;EAAA,QAQA,gBAAA;AAAA"}

package/dist/impls/notion.d.ts

@@ -0,0 +1,27 @@
+import { project_management_d_exports } from "../project-management.js";
+import { Client } from "@notionhq/client";
+
+//#region src/impls/notion.d.ts
+interface NotionProjectManagementProviderOptions {
+  apiKey: string;
+  databaseId?: string;
+  summaryParentPageId?: string;
+  titleProperty?: string;
+  statusProperty?: string;
+  priorityProperty?: string;
+  tagsProperty?: string;
+  dueDateProperty?: string;
+  descriptionProperty?: string;
+  client?: Client;
+}
+declare class NotionProjectManagementProvider implements project_management_d_exports.ProjectManagementProvider {
+  private readonly client;
+  private readonly defaults;
+  constructor(options: NotionProjectManagementProviderOptions);
+  createWorkItem(input: project_management_d_exports.ProjectManagementWorkItemInput): Promise<project_management_d_exports.ProjectManagementWorkItem>;
+  createWorkItems(items: project_management_d_exports.ProjectManagementWorkItemInput[]): Promise<project_management_d_exports.ProjectManagementWorkItem[]>;
+  private createSummaryPage;
+}
+//#endregion
+export { NotionProjectManagementProvider, NotionProjectManagementProviderOptions };
+//# sourceMappingURL=notion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notion.d.ts","names":[],"sources":["../../src/impls/notion.ts"],"mappings":";;;;UAOiB,sCAAA;EACf,MAAA;EACA,UAAA;EACA,mBAAA;EACA,aAAA;EACA,cAAA;EACA,gBAAA;EACA,YAAA;EACA,eAAA;EACA,mBAAA;EACA,MAAA,GAAS,MAAA;AAAA;AAAA,cAyBE,+BAAA,YAA2C,4BAAA,CAAA,yBAAA;EAAA,iBACrC,MAAA;EAAA,iBACA,QAAA;cAKL,OAAA,EAAS,sCAAA;EAcf,cAAA,CACJ,KAAA,EAAO,4BAAA,CAAA,8BAAA,GACN,OAAA,CAAQ,4BAAA,CAAA,yBAAA;EA2CL,eAAA,CACJ,KAAA,EAAO,4BAAA,CAAA,8BAAA,KACN,OAAA,CAAQ,4BAAA,CAAA,yBAAA;EAAA,QAQG,iBAAA;AAAA"}

package/dist/impls/notion.js

@@ -0,0 +1,126 @@
+import { Client } from "@notionhq/client";
+
+//#region src/impls/notion.ts
+var NotionProjectManagementProvider = class {
+	client;
+	defaults;
+	constructor(options) {
+		this.client = options.client ?? new Client({ auth: options.apiKey });
+		this.defaults = {
+			databaseId: options.databaseId,
+			summaryParentPageId: options.summaryParentPageId,
+			titleProperty: options.titleProperty,
+			statusProperty: options.statusProperty,
+			priorityProperty: options.priorityProperty,
+			tagsProperty: options.tagsProperty,
+			dueDateProperty: options.dueDateProperty,
+			descriptionProperty: options.descriptionProperty
+		};
+	}
+	async createWorkItem(input) {
+		if (input.type === "summary" && this.defaults.summaryParentPageId) return this.createSummaryPage(input);
+		const databaseId = this.defaults.databaseId;
+		if (!databaseId) throw new Error("Notion databaseId is required to create work items.");
+		const properties = { [this.defaults.titleProperty ?? "Name"]: buildTitleProperty(input.title) };
+		applySelect(properties, this.defaults.statusProperty, input.status);
+		applySelect(properties, this.defaults.priorityProperty, input.priority);
+		applyMultiSelect(properties, this.defaults.tagsProperty, input.tags);
+		applyDate(properties, this.defaults.dueDateProperty, input.dueDate);
+		applyRichText(properties, this.defaults.descriptionProperty, input.description);
+		const page = await this.client.pages.create({
+			parent: {
+				type: "database_id",
+				database_id: databaseId
+			},
+			properties
+		});
+		return {
+			id: page.id,
+			title: input.title,
+			url: "url" in page ? page.url : void 0,
+			status: input.status,
+			priority: input.priority,
+			tags: input.tags,
+			projectId: databaseId,
+			externalId: input.externalId,
+			metadata: input.metadata
+		};
+	}
+	async createWorkItems(items) {
+		const created = [];
+		for (const item of items) created.push(await this.createWorkItem(item));
+		return created;
+	}
+	async createSummaryPage(input) {
+		const parentId = this.defaults.summaryParentPageId;
+		if (!parentId) throw new Error("Notion summaryParentPageId is required for summaries.");
+		const summaryProperties = { title: buildTitleProperty(input.title) };
+		const page = await this.client.pages.create({
+			parent: {
+				type: "page_id",
+				page_id: parentId
+			},
+			properties: summaryProperties
+		});
+		if (input.description) {
+			const children = buildParagraphBlocks(input.description);
+			if (children.length > 0) await this.client.blocks.children.append({
+				block_id: page.id,
+				children
+			});
+		}
+		return {
+			id: page.id,
+			title: input.title,
+			url: "url" in page ? page.url : void 0,
+			status: input.status,
+			priority: input.priority,
+			tags: input.tags,
+			projectId: parentId,
+			externalId: input.externalId,
+			metadata: input.metadata
+		};
+	}
+};
+function buildTitleProperty(title) {
+	return { title: [{
+		type: "text",
+		text: { content: title }
+	}] };
+}
+function buildRichText(text) {
+	return { rich_text: [{
+		type: "text",
+		text: { content: text }
+	}] };
+}
+function applySelect(properties, property, value) {
+	if (!property || !value) return;
+	properties[property] = { select: { name: value } };
+}
+function applyMultiSelect(properties, property, values) {
+	if (!property || !values || values.length === 0) return;
+	properties[property] = { multi_select: values.map((value) => ({ name: value })) };
+}
+function applyDate(properties, property, value) {
+	if (!property || !value) return;
+	properties[property] = { date: { start: value.toISOString() } };
+}
+function applyRichText(properties, property, value) {
+	if (!property || !value) return;
+	properties[property] = buildRichText(value);
+}
+function buildParagraphBlocks(text) {
+	return text.split(/\r?\n/).filter((line) => line.trim()).map((line) => ({
+		object: "block",
+		type: "paragraph",
+		paragraph: { rich_text: [{
+			type: "text",
+			text: { content: line }
+		}] }
+	}));
+}
+
+//#endregion
+export { NotionProjectManagementProvider };
+//# sourceMappingURL=notion.js.map

package/dist/impls/notion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion.js","names":[],"sources":["../../src/impls/notion.ts"],"sourcesContent":["import { Client } from '@notionhq/client';\nimport type {\n  ProjectManagementProvider,\n  ProjectManagementWorkItem,\n  ProjectManagementWorkItemInput,\n} from '../project-management';\n\nexport interface NotionProjectManagementProviderOptions {\n  apiKey: string;\n  databaseId?: string;\n  summaryParentPageId?: string;\n  titleProperty?: string;\n  statusProperty?: string;\n  priorityProperty?: string;\n  tagsProperty?: string;\n  dueDateProperty?: string;\n  descriptionProperty?: string;\n  client?: Client;\n}\n\ntype NotionPageCreateParams = Parameters<Client['pages']['create']>[0];\ntype NotionPropertyRecord = Extract<\n  NotionPageCreateParams['properties'],\n  Record<string, { type?: string }>\n>;\ntype NotionPropertyValue = NotionPropertyRecord[string];\ntype NotionTitleProperty = Extract<NotionPropertyValue, { title: unknown[] }>;\ntype NotionRichTextProperty = Extract<\n  NotionPropertyValue,\n  { rich_text: unknown[] }\n>;\ntype NotionSelectProperty = Extract<NotionPropertyValue, { select: unknown }>;\ntype NotionMultiSelectProperty = Extract<\n  NotionPropertyValue,\n  { multi_select: unknown }\n>;\ntype NotionDateProperty = Extract<NotionPropertyValue, { date: unknown }>;\ntype NotionAppendChildrenParams = Parameters<\n  Client['blocks']['children']['append']\n>[0];\ntype NotionBlockChildren = NotionAppendChildrenParams['children'];\n\nexport class NotionProjectManagementProvider implements ProjectManagementProvider {\n  private readonly client: Client;\n  private readonly defaults: Omit<\n    NotionProjectManagementProviderOptions,\n    'apiKey' | 'client'\n  >;\n\n  constructor(options: NotionProjectManagementProviderOptions) {\n    this.client = options.client ?? new Client({ auth: options.apiKey });\n    this.defaults = {\n      databaseId: options.databaseId,\n      summaryParentPageId: options.summaryParentPageId,\n      titleProperty: options.titleProperty,\n      statusProperty: options.statusProperty,\n      priorityProperty: options.priorityProperty,\n      tagsProperty: options.tagsProperty,\n      dueDateProperty: options.dueDateProperty,\n      descriptionProperty: options.descriptionProperty,\n    };\n  }\n\n  async createWorkItem(\n    input: ProjectManagementWorkItemInput\n  ): Promise<ProjectManagementWorkItem> {\n    if (input.type === 'summary' && this.defaults.summaryParentPageId) {\n      return this.createSummaryPage(input);\n    }\n\n    const databaseId = this.defaults.databaseId;\n    if (!databaseId) {\n      throw new Error('Notion databaseId is required to create work items.');\n    }\n\n    const titleProperty = this.defaults.titleProperty ?? 'Name';\n    const properties: NotionPropertyRecord = {\n      [titleProperty]: buildTitleProperty(input.title),\n    };\n\n    applySelect(properties, this.defaults.statusProperty, input.status);\n    applySelect(properties, this.defaults.priorityProperty, input.priority);\n    applyMultiSelect(properties, this.defaults.tagsProperty, input.tags);\n    applyDate(properties, this.defaults.dueDateProperty, input.dueDate);\n    applyRichText(\n      properties,\n      this.defaults.descriptionProperty,\n      input.description\n    );\n\n    const page = await this.client.pages.create({\n      parent: { type: 'database_id', database_id: databaseId },\n      properties,\n    });\n\n    return {\n      id: page.id,\n      title: input.title,\n      url: 'url' in page ? (page.url as string | undefined) : undefined,\n      status: input.status,\n      priority: input.priority,\n      tags: input.tags,\n      projectId: databaseId,\n      externalId: input.externalId,\n      metadata: input.metadata,\n    };\n  }\n\n  async createWorkItems(\n    items: ProjectManagementWorkItemInput[]\n  ): Promise<ProjectManagementWorkItem[]> {\n    const created: ProjectManagementWorkItem[] = [];\n    for (const item of items) {\n      created.push(await this.createWorkItem(item));\n    }\n    return created;\n  }\n\n  private async createSummaryPage(\n    input: ProjectManagementWorkItemInput\n  ): Promise<ProjectManagementWorkItem> {\n    const parentId = this.defaults.summaryParentPageId;\n    if (!parentId) {\n      throw new Error('Notion summaryParentPageId is required for summaries.');\n    }\n\n    const summaryProperties: NotionPropertyRecord = {\n      title: buildTitleProperty(input.title),\n    };\n    const page = await this.client.pages.create({\n      parent: { type: 'page_id', page_id: parentId },\n      properties: summaryProperties,\n    });\n\n    if (input.description) {\n      const children = buildParagraphBlocks(input.description);\n      if (children.length > 0) {\n        await this.client.blocks.children.append({\n          block_id: page.id,\n          children,\n        });\n      }\n    }\n\n    return {\n      id: page.id,\n      title: input.title,\n      url: 'url' in page ? (page.url as string | undefined) : undefined,\n      status: input.status,\n      priority: input.priority,\n      tags: input.tags,\n      projectId: parentId,\n      externalId: input.externalId,\n      metadata: input.metadata,\n    };\n  }\n}\n\nfunction buildTitleProperty(title: string): NotionTitleProperty {\n  return {\n    title: [\n      {\n        type: 'text' as const,\n        text: { content: title },\n      },\n    ],\n  };\n}\n\nfunction buildRichText(text: string): NotionRichTextProperty {\n  return {\n    rich_text: [\n      {\n        type: 'text' as const,\n        text: { content: text },\n      },\n    ],\n  };\n}\n\nfunction applySelect(\n  properties: NotionPropertyRecord,\n  property: string | undefined,\n  value: string | undefined\n) {\n  if (!property || !value) return;\n  const next: NotionSelectProperty = {\n    select: { name: value },\n  };\n  properties[property] = next;\n}\n\nfunction applyMultiSelect(\n  properties: NotionPropertyRecord,\n  property: string | undefined,\n  values?: string[]\n) {\n  if (!property || !values || values.length === 0) return;\n  const next: NotionMultiSelectProperty = {\n    multi_select: values.map((value) => ({ name: value })),\n  };\n  properties[property] = next;\n}\n\nfunction applyDate(\n  properties: NotionPropertyRecord,\n  property: string | undefined,\n  value?: Date\n) {\n  if (!property || !value) return;\n  const next: NotionDateProperty = {\n    date: { start: value.toISOString() },\n  };\n  properties[property] = next;\n}\n\nfunction applyRichText(\n  properties: NotionPropertyRecord,\n  property: string | undefined,\n  value?: string\n) {\n  if (!property || !value) return;\n  properties[property] = buildRichText(value);\n}\n\nfunction buildParagraphBlocks(text: string): NotionBlockChildren {\n  const lines = text.split(/\\r?\\n/).filter((line) => line.trim());\n  return lines.map((line) => ({\n    object: 'block' as const,\n    type: 'paragraph' as const,\n    paragraph: {\n      rich_text: [\n        {\n          type: 'text' as const,\n          text: { content: line },\n        },\n      ],\n    },\n  }));\n}\n"],"mappings":"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"}

package/dist/impls/posthog-reader.d.ts

@@ -0,0 +1,26 @@
+import { analytics_d_exports } from "../analytics.js";
+
+//#region src/impls/posthog-reader.d.ts
+interface PosthogReaderClient {
+  request<T = unknown>(request: analytics_d_exports.AnalyticsRequest): Promise<analytics_d_exports.AnalyticsResponse<T>>;
+}
+interface PosthogAnalyticsReaderOptions {
+  projectId?: string | number;
+  client: PosthogReaderClient;
+}
+declare class PosthogAnalyticsReader implements analytics_d_exports.AnalyticsReader {
+  private readonly projectId?;
+  private readonly client;
+  constructor(options: PosthogAnalyticsReaderOptions);
+  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>>;
+}
+//#endregion
+export { PosthogAnalyticsReader, PosthogAnalyticsReaderOptions, PosthogReaderClient };
+//# sourceMappingURL=posthog-reader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-reader.d.ts","names":[],"sources":["../../src/impls/posthog-reader.ts"],"mappings":";;;UAuBiB,mBAAA;EACf,OAAA,cACE,OAAA,EAAS,mBAAA,CAAA,gBAAA,GACR,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,CAAA;AAAA;AAAA,UAGd,6BAAA;EACf,SAAA;EACA,MAAA,EAAQ,mBAAA;AAAA;AAAA,cAGG,sBAAA,YAAkC,mBAAA,CAAA,eAAA;EAAA,iBAC5B,SAAA;EAAA,iBACA,MAAA;cAEL,OAAA,EAAS,6BAAA;EAKf,UAAA,CAAW,KAAA,EAAO,mBAAA,CAAA,mBAAA,GAAsB,OAAA,CAAQ,mBAAA,CAAA,oBAAA;EAgBhD,SAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,cAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,cAAA;EAuBvB,UAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,eAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,eAAA;EAoBvB,WAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,gBAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,gBAAA;EAgBvB,gBAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,qBAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,gBAAA;EASL,UAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,eAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,eAAA;EAevB,eAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,oBAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,oBAAA;EAgBvB,cAAA,CACJ,KAAA,EAAO,mBAAA,CAAA,mBAAA,GACN,OAAA,CAAQ,mBAAA,CAAA,iBAAA,CAAkB,mBAAA,CAAA,mBAAA;AAAA"}

package/dist/impls/posthog-reader.js

@@ -0,0 +1,141 @@
+//#region src/impls/posthog-reader.ts
+var PosthogAnalyticsReader = class {
+	projectId;
+	client;
+	constructor(options) {
+		this.projectId = options.projectId;
+		this.client = options.client;
+	}
+	async queryHogQL(input) {
+		const projectId = resolveProjectId(void 0, this.projectId);
+		return (await this.client.request({
+			method: "POST",
+			path: `/api/projects/${projectId}/query`,
+			body: { query: {
+				kind: "HogQLQuery",
+				query: input.query,
+				values: input.values
+			} }
+		})).data;
+	}
+	async getEvents(input) {
+		const projectId = resolveProjectId(input.projectId, this.projectId);
+		return (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) : void 0,
+				...buildEventDateQuery(input.dateRange)
+			}
+		})).data;
+	}
+	async getPersons(input) {
+		const projectId = resolveProjectId(input.projectId, this.projectId);
+		return (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) : void 0
+			}
+		})).data;
+	}
+	async getInsights(input) {
+		const projectId = resolveProjectId(input.projectId, this.projectId);
+		return (await this.client.request({
+			method: "GET",
+			path: `/api/projects/${projectId}/insights/`,
+			query: {
+				insight: input.insightType,
+				limit: input.limit,
+				offset: input.offset
+			}
+		})).data;
+	}
+	async getInsightResult(input) {
+		const projectId = resolveProjectId(input.projectId, this.projectId);
+		return (await this.client.request({
+			method: "GET",
+			path: `/api/projects/${projectId}/insights/${input.insightId}/`
+		})).data;
+	}
+	async getCohorts(input) {
+		const projectId = resolveProjectId(input.projectId, this.projectId);
+		return (await this.client.request({
+			method: "GET",
+			path: `/api/projects/${projectId}/cohorts/`,
+			query: {
+				limit: input.limit,
+				offset: input.offset
+			}
+		})).data;
+	}
+	async getFeatureFlags(input) {
+		const projectId = resolveProjectId(input.projectId, this.projectId);
+		return (await this.client.request({
+			method: "GET",
+			path: `/api/projects/${projectId}/feature_flags/`,
+			query: {
+				active: input.active,
+				limit: input.limit,
+				offset: input.offset
+			}
+		})).data;
+	}
+	async getAnnotations(input) {
+		const projectId = resolveProjectId(input.projectId, this.projectId);
+		return (await this.client.request({
+			method: "GET",
+			path: `/api/projects/${projectId}/annotations/`,
+			query: {
+				limit: input.limit,
+				offset: input.offset,
+				...buildAnnotationDateQuery(input.dateRange)
+			}
+		})).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 void 0;
+	return events[0];
+}
+function resolveEventList(events) {
+	if (!events || events.length <= 1) return void 0;
+	return events.join(",");
+}
+function buildEventDateQuery(range) {
+	return {
+		after: formatDate(range?.from),
+		before: formatDate(range?.to),
+		timezone: range?.timezone
+	};
+}
+function buildAnnotationDateQuery(range) {
+	return {
+		date_from: formatDate(range?.from),
+		date_to: formatDate(range?.to),
+		timezone: range?.timezone
+	};
+}
+function formatDate(value) {
+	if (!value) return void 0;
+	return typeof value === "string" ? value : value.toISOString();
+}
+
+//#endregion
+export { PosthogAnalyticsReader };
+//# sourceMappingURL=posthog-reader.js.map

package/dist/impls/posthog-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-reader.js","names":[],"sources":["../../src/impls/posthog-reader.ts"],"sourcesContent":["import type {\n  AnalyticsReader,\n  AnalyticsQueryInput,\n  AnalyticsQueryResult,\n  AnalyticsRequest,\n  AnalyticsResponse,\n  AnalyticsEvent,\n  AnalyticsPerson,\n  AnalyticsInsight,\n  AnalyticsCohort,\n  AnalyticsFeatureFlag,\n  AnalyticsAnnotation,\n  DateRangeInput,\n  GetEventsInput,\n  GetPersonsInput,\n  GetInsightsInput,\n  GetInsightResultInput,\n  GetCohortsInput,\n  GetFeatureFlagsInput,\n  GetAnnotationsInput,\n  PaginatedResponse,\n} from '../analytics';\n\nexport interface PosthogReaderClient {\n  request<T = unknown>(\n    request: AnalyticsRequest\n  ): Promise<AnalyticsResponse<T>>;\n}\n\nexport interface PosthogAnalyticsReaderOptions {\n  projectId?: string | number;\n  client: PosthogReaderClient;\n}\n\nexport class PosthogAnalyticsReader implements AnalyticsReader {\n  private readonly projectId?: string | number;\n  private readonly client: PosthogReaderClient;\n\n  constructor(options: PosthogAnalyticsReaderOptions) {\n    this.projectId = options.projectId;\n    this.client = options.client;\n  }\n\n  async queryHogQL(input: AnalyticsQueryInput): Promise<AnalyticsQueryResult> {\n    const projectId = resolveProjectId(undefined, this.projectId);\n    const response = await this.client.request<AnalyticsQueryResult>({\n      method: 'POST',\n      path: `/api/projects/${projectId}/query`,\n      body: {\n        query: {\n          kind: 'HogQLQuery',\n          query: input.query,\n          values: input.values,\n        },\n      },\n    });\n    return response.data;\n  }\n\n  async getEvents(\n    input: GetEventsInput\n  ): Promise<PaginatedResponse<AnalyticsEvent>> {\n    const projectId = resolveProjectId(input.projectId, this.projectId);\n    const response = await this.client.request<\n      PaginatedResponse<AnalyticsEvent>\n    >({\n      method: 'GET',\n      path: `/api/projects/${projectId}/events/`,\n      query: {\n        event: input.event ?? resolveSingleEvent(input.events),\n        events: resolveEventList(input.events),\n        distinct_id: input.distinctId,\n        order_by: input.orderBy,\n        limit: input.limit,\n        offset: input.offset,\n        properties: input.properties\n          ? JSON.stringify(input.properties)\n          : undefined,\n        ...buildEventDateQuery(input.dateRange),\n      },\n    });\n    return response.data;\n  }\n\n  async getPersons(\n    input: GetPersonsInput\n  ): Promise<PaginatedResponse<AnalyticsPerson>> {\n    const projectId = resolveProjectId(input.projectId, this.projectId);\n    const response = await this.client.request<\n      PaginatedResponse<AnalyticsPerson>\n    >({\n      method: 'GET',\n      path: `/api/projects/${projectId}/persons/`,\n      query: {\n        cohort_id: input.cohortId,\n        search: input.search,\n        limit: input.limit,\n        offset: input.offset,\n        properties: input.properties\n          ? JSON.stringify(input.properties)\n          : undefined,\n      },\n    });\n    return response.data;\n  }\n\n  async getInsights(\n    input: GetInsightsInput\n  ): Promise<PaginatedResponse<AnalyticsInsight>> {\n    const projectId = resolveProjectId(input.projectId, this.projectId);\n    const response = await this.client.request<\n      PaginatedResponse<AnalyticsInsight>\n    >({\n      method: 'GET',\n      path: `/api/projects/${projectId}/insights/`,\n      query: {\n        insight: input.insightType,\n        limit: input.limit,\n        offset: input.offset,\n      },\n    });\n    return response.data;\n  }\n\n  async getInsightResult(\n    input: GetInsightResultInput\n  ): Promise<AnalyticsInsight> {\n    const projectId = resolveProjectId(input.projectId, this.projectId);\n    const response = await this.client.request<AnalyticsInsight>({\n      method: 'GET',\n      path: `/api/projects/${projectId}/insights/${input.insightId}/`,\n    });\n    return response.data;\n  }\n\n  async getCohorts(\n    input: GetCohortsInput\n  ): Promise<PaginatedResponse<AnalyticsCohort>> {\n    const projectId = resolveProjectId(input.projectId, this.projectId);\n    const response = await this.client.request<\n      PaginatedResponse<AnalyticsCohort>\n    >({\n      method: 'GET',\n      path: `/api/projects/${projectId}/cohorts/`,\n      query: {\n        limit: input.limit,\n        offset: input.offset,\n      },\n    });\n    return response.data;\n  }\n\n  async getFeatureFlags(\n    input: GetFeatureFlagsInput\n  ): Promise<PaginatedResponse<AnalyticsFeatureFlag>> {\n    const projectId = resolveProjectId(input.projectId, this.projectId);\n    const response = await this.client.request<\n      PaginatedResponse<AnalyticsFeatureFlag>\n    >({\n      method: 'GET',\n      path: `/api/projects/${projectId}/feature_flags/`,\n      query: {\n        active: input.active,\n        limit: input.limit,\n        offset: input.offset,\n      },\n    });\n    return response.data;\n  }\n\n  async getAnnotations(\n    input: GetAnnotationsInput\n  ): Promise<PaginatedResponse<AnalyticsAnnotation>> {\n    const projectId = resolveProjectId(input.projectId, this.projectId);\n    const response = await this.client.request<\n      PaginatedResponse<AnalyticsAnnotation>\n    >({\n      method: 'GET',\n      path: `/api/projects/${projectId}/annotations/`,\n      query: {\n        limit: input.limit,\n        offset: input.offset,\n        ...buildAnnotationDateQuery(input.dateRange),\n      },\n    });\n    return response.data;\n  }\n}\n\nfunction resolveProjectId(\n  inputProjectId: string | number | undefined,\n  defaultProjectId: string | number | undefined\n): string | number {\n  const projectId = inputProjectId ?? defaultProjectId;\n  if (!projectId) {\n    throw new Error('PostHog projectId is required for API reads.');\n  }\n  return projectId;\n}\n\nfunction resolveSingleEvent(events?: string[]): string | undefined {\n  if (!events || events.length !== 1) return undefined;\n  return events[0];\n}\n\nfunction resolveEventList(events?: string[]): string | undefined {\n  if (!events || events.length <= 1) return undefined;\n  return events.join(',');\n}\n\nfunction buildEventDateQuery(\n  range?: DateRangeInput\n): Record<string, string | undefined> {\n  const after = formatDate(range?.from);\n  const before = formatDate(range?.to);\n  return {\n    after,\n    before,\n    timezone: range?.timezone,\n  };\n}\n\nfunction buildAnnotationDateQuery(\n  range?: DateRangeInput\n): Record<string, string | undefined> {\n  const dateFrom = formatDate(range?.from);\n  const dateTo = formatDate(range?.to);\n  return {\n    date_from: dateFrom,\n    date_to: dateTo,\n    timezone: range?.timezone,\n  };\n}\n\nfunction formatDate(value?: string | Date): string | undefined {\n  if (!value) return undefined;\n  return typeof value === 'string' ? value : value.toISOString();\n}\n"],"mappings":"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"}

package/dist/impls/posthog-utils.d.ts

@@ -0,0 +1,8 @@
+//#region src/impls/posthog-utils.d.ts
+declare function normalizeHost(host: string): string;
+declare function buildUrl(host: string, path: string, query?: Record<string, string | number | boolean | undefined>): string;
+declare function appendQuery(url: string, query?: Record<string, string | number | boolean | undefined>): string;
+declare function parseJson<T>(value: string): T;
+//#endregion
+export { appendQuery, buildUrl, normalizeHost, parseJson };
+//# sourceMappingURL=posthog-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-utils.d.ts","names":[],"sources":["../../src/impls/posthog-utils.ts"],"mappings":";iBAAgB,aAAA,CAAc,IAAA;AAAA,iBAId,QAAA,CACd,IAAA,UACA,IAAA,UACA,KAAA,GAAQ,MAAA;AAAA,iBASM,WAAA,CACd,GAAA,UACA,KAAA,GAAQ,MAAA;AAAA,iBAYM,SAAA,GAAA,CAAa,KAAA,WAAgB,CAAA"}

package/dist/impls/posthog-utils.js

@@ -0,0 +1,30 @@
+//#region src/impls/posthog-utils.ts
+function normalizeHost(host) {
+	return host.replace(/\/$/, "");
+}
+function buildUrl(host, path, query) {
+	if (/^https?:\/\//.test(path)) return appendQuery(path, query);
+	return appendQuery(`${host}/${path.replace(/^\/+/, "")}`, 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;
+}
+function parseJson(value) {
+	if (!value) return {};
+	try {
+		return JSON.parse(value);
+	} catch {
+		return value;
+	}
+}
+
+//#endregion
+export { appendQuery, buildUrl, normalizeHost, parseJson };
+//# sourceMappingURL=posthog-utils.js.map

package/dist/impls/posthog-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-utils.js","names":[],"sources":["../../src/impls/posthog-utils.ts"],"sourcesContent":["export function normalizeHost(host: string): string {\n  return host.replace(/\\/$/, '');\n}\n\nexport function buildUrl(\n  host: string,\n  path: string,\n  query?: Record<string, string | number | boolean | undefined>\n): string {\n  if (/^https?:\\/\\//.test(path)) {\n    return appendQuery(path, query);\n  }\n  const normalizedPath = path.replace(/^\\/+/, '');\n  return appendQuery(`${host}/${normalizedPath}`, query);\n}\n\nexport function appendQuery(\n  url: string,\n  query?: Record<string, string | number | boolean | undefined>\n): string {\n  if (!query) return url;\n  const params = new URLSearchParams();\n  Object.entries(query).forEach(([key, value]) => {\n    if (value === undefined) return;\n    params.set(key, String(value));\n  });\n  const suffix = params.toString();\n  return suffix ? `${url}?${suffix}` : url;\n}\n\nexport function parseJson<T>(value: string): T {\n  if (!value) return {} as T;\n  try {\n    return JSON.parse(value) as T;\n  } catch {\n    return value as T;\n  }\n}\n"],"mappings":";AAAA,SAAgB,cAAc,MAAsB;AAClD,QAAO,KAAK,QAAQ,OAAO,GAAG;;AAGhC,SAAgB,SACd,MACA,MACA,OACQ;AACR,KAAI,eAAe,KAAK,KAAK,CAC3B,QAAO,YAAY,MAAM,MAAM;AAGjC,QAAO,YAAY,GAAG,KAAK,GADJ,KAAK,QAAQ,QAAQ,GAAG,IACC,MAAM;;AAGxD,SAAgB,YACd,KACA,OACQ;AACR,KAAI,CAAC,MAAO,QAAO;CACnB,MAAM,SAAS,IAAI,iBAAiB;AACpC,QAAO,QAAQ,MAAM,CAAC,SAAS,CAAC,KAAK,WAAW;AAC9C,MAAI,UAAU,OAAW;AACzB,SAAO,IAAI,KAAK,OAAO,MAAM,CAAC;GAC9B;CACF,MAAM,SAAS,OAAO,UAAU;AAChC,QAAO,SAAS,GAAG,IAAI,GAAG,WAAW;;AAGvC,SAAgB,UAAa,OAAkB;AAC7C,KAAI,CAAC,MAAO,QAAO,EAAE;AACrB,KAAI;AACF,SAAO,KAAK,MAAM,MAAM;SAClB;AACN,SAAO"}

package/dist/impls/posthog.d.ts

@@ -0,0 +1,40 @@
+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;
+}
+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>;
+}
+//#endregion
+export { PosthogAnalyticsProvider, PosthogAnalyticsProviderOptions };
+//# sourceMappingURL=posthog.d.ts.map

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

@@ -0,0 +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"}