@keystrokehq/posthog 0.0.1

package/dist/webhook-management.d.mts

@@ -0,0 +1,188 @@
+import { z } from "zod";
+import * as _keystrokehq_core_credential_set0 from "@keystrokehq/core/credential-set";
+import * as _keystrokehq_core0 from "@keystrokehq/core";
+
+//#region src/webhook-management.d.ts
+declare const listActionWebhooks: _keystrokehq_core0.Operation<z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  next: z.ZodNullable<z.ZodString>;
+  previous: z.ZodNullable<z.ZodString>;
+  count: z.ZodNumber;
+  results: z.ZodArray<z.ZodObject<{
+    id: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    post_to_slack: z.ZodOptional<z.ZodBoolean>;
+    slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        exact: "exact";
+        contains: "contains";
+        regex: "regex";
+      }>>>;
+      text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+    }, z.core.$strip>>>;
+    created_at: z.ZodOptional<z.ZodString>;
+    created_by: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    deleted: z.ZodOptional<z.ZodBoolean>;
+    is_calculating: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const attachActionWebhook: _keystrokehq_core0.Operation<z.ZodObject<{
+  slack_message_format: z.ZodString;
+  actionId: z.ZodNumber;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  id: z.ZodOptional<z.ZodNumber>;
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  post_to_slack: z.ZodOptional<z.ZodBoolean>;
+  slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      exact: "exact";
+      contains: "contains";
+      regex: "regex";
+    }>>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+  }, z.core.$strip>>>;
+  created_at: z.ZodOptional<z.ZodString>;
+  created_by: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  deleted: z.ZodOptional<z.ZodBoolean>;
+  is_calculating: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const detachActionWebhook: _keystrokehq_core0.Operation<z.ZodObject<{
+  actionId: z.ZodNumber;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  id: z.ZodOptional<z.ZodNumber>;
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  post_to_slack: z.ZodOptional<z.ZodBoolean>;
+  slack_message_format: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    event: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    url_matching: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      exact: "exact";
+      contains: "contains";
+      regex: "regex";
+    }>>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    href: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    selector: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    properties: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
+  }, z.core.$strip>>>;
+  created_at: z.ZodOptional<z.ZodString>;
+  created_by: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  deleted: z.ZodOptional<z.ZodBoolean>;
+  is_calculating: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const listPipelineDestinations: _keystrokehq_core0.Operation<z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  next: z.ZodNullable<z.ZodString>;
+  previous: z.ZodNullable<z.ZodString>;
+  count: z.ZodNumber;
+  results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const createPipelineDestination: _keystrokehq_core0.Operation<z.ZodObject<{
+  plugin: z.ZodNumber;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  order: z.ZodOptional<z.ZodNumber>;
+  config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodRecord<z.ZodString, z.ZodUnknown>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const deletePipelineDestination: _keystrokehq_core0.Operation<z.ZodObject<{
+  pluginConfigId: z.ZodNumber;
+  projectId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+  success: z.ZodBoolean;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"posthog", z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  POSTHOG_PERSONAL_API_KEY: z.ZodString;
+  POSTHOG_PROJECT_API_KEY: z.ZodOptional<z.ZodString>;
+  POSTHOG_HOST: z.ZodDefault<z.ZodURL>;
+  POSTHOG_PROJECT_ID: z.ZodOptional<z.ZodString>;
+  POSTHOG_SCOPES: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+//#endregion
+export { attachActionWebhook, createPipelineDestination, deletePipelineDestination, detachActionWebhook, listActionWebhooks, listPipelineDestinations };

package/dist/webhook-management.mjs

@@ -0,0 +1,152 @@
+import { createPosthogManagementClient } from "./client.mjs";
+import { actionSchema, paginatedResponseSchema, projectIdInputShape } from "./schemas.mjs";
+import { t as posthogOperation } from "./factory-DYDvHOGb.mjs";
+import { z } from "zod";
+
+//#region src/webhook-management.ts
+/**
+* posthog/webhook-management.ts
+*
+* Helpers to manage PostHog Action webhooks + pipeline destination
+* webhooks programmatically.
+*
+* Pass A exposes thin CRUD wrappers; the actual direct-binding webhook
+* triggers (T2 action match, T4 pipeline destination) are deferred to
+* Pass B because PostHog delivers those payloads unsigned and requires
+* explicit product decisions on URL-embedded secrets vs. IP allowlisting.
+*/
+const actionIdInput = {
+	...projectIdInputShape,
+	actionId: z.number().int()
+};
+const listActionWebhooks = posthogOperation({
+	id: "posthog_action_webhooks_list",
+	name: "PostHog List Action Webhooks",
+	description: "List actions configured to post to a Slack webhook",
+	input: z.object({
+		...projectIdInputShape,
+		limit: z.number().int().min(1).max(500).optional()
+	}),
+	output: paginatedResponseSchema(actionSchema),
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		return client.request({
+			method: "GET",
+			path: `/api/projects/${projectId}/actions/`,
+			query: {
+				limit: input.limit,
+				post_to_slack: true
+			}
+		});
+	}
+});
+const attachActionWebhook = posthogOperation({
+	id: "posthog_action_webhooks_attach",
+	name: "PostHog Attach Action Webhook",
+	description: "Enable Slack-webhook posting on an action with a message format",
+	input: z.object({
+		...actionIdInput,
+		slack_message_format: z.string().min(1)
+	}),
+	output: actionSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		return client.request({
+			method: "PATCH",
+			path: `/api/projects/${projectId}/actions/${input.actionId}/`,
+			body: {
+				post_to_slack: true,
+				slack_message_format: input.slack_message_format
+			}
+		});
+	}
+});
+const detachActionWebhook = posthogOperation({
+	id: "posthog_action_webhooks_detach",
+	name: "PostHog Detach Action Webhook",
+	description: "Disable Slack-webhook posting on an action",
+	input: z.object(actionIdInput),
+	output: actionSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		return client.request({
+			method: "PATCH",
+			path: `/api/projects/${projectId}/actions/${input.actionId}/`,
+			body: {
+				post_to_slack: false,
+				slack_message_format: null
+			}
+		});
+	}
+});
+const listPipelineDestinations = posthogOperation({
+	id: "posthog_pipeline_destinations_list",
+	name: "PostHog List Pipeline Destinations",
+	description: "List configured pipeline destinations (plugin-configs)",
+	input: z.object({
+		...projectIdInputShape,
+		limit: z.number().int().min(1).max(500).optional()
+	}),
+	output: paginatedResponseSchema(z.record(z.string(), z.unknown())),
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		return client.request({
+			method: "GET",
+			path: `/api/projects/${projectId}/plugin_configs/`,
+			query: { limit: input.limit }
+		});
+	}
+});
+const createPipelineDestination = posthogOperation({
+	id: "posthog_pipeline_destinations_create",
+	name: "PostHog Create Pipeline Destination",
+	description: "Configure a pipeline destination plugin (e.g. webhook delivery)",
+	input: z.object({
+		...projectIdInputShape,
+		plugin: z.number().int(),
+		enabled: z.boolean().default(true),
+		order: z.number().int().optional(),
+		config: z.record(z.string(), z.unknown())
+	}),
+	output: z.record(z.string(), z.unknown()),
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		const { projectId: _pid, ...body } = input;
+		return client.request({
+			method: "POST",
+			path: `/api/projects/${projectId}/plugin_configs/`,
+			body
+		});
+	}
+});
+const deletePipelineDestination = posthogOperation({
+	id: "posthog_pipeline_destinations_delete",
+	name: "PostHog Delete Pipeline Destination",
+	description: "Remove a pipeline destination configuration",
+	input: z.object({
+		...projectIdInputShape,
+		pluginConfigId: z.number().int()
+	}),
+	output: z.object({ success: z.boolean() }),
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const client = createPosthogManagementClient(credentials);
+		const projectId = client.projectId(input.projectId);
+		await client.request({
+			method: "DELETE",
+			path: `/api/projects/${projectId}/plugin_configs/${input.pluginConfigId}/`
+		});
+		return { success: true };
+	}
+});
+
+//#endregion
+export { attachActionWebhook, createPipelineDestination, deletePipelineDestination, detachActionWebhook, listActionWebhooks, listPipelineDestinations };

package/package.json

@@ -0,0 +1,147 @@
+{
+  "name": "@keystrokehq/posthog",
+  "version": "0.0.1",
+  "private": false,
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./connection": {
+      "types": "./dist/connection.d.mts",
+      "default": "./dist/connection.mjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.mts",
+      "default": "./dist/client.mjs"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.mts",
+      "default": "./dist/errors.mjs"
+    },
+    "./schemas": {
+      "types": "./dist/schemas.d.mts",
+      "default": "./dist/schemas.mjs"
+    },
+    "./_official": {
+      "types": "./dist/_official/index.d.mts",
+      "default": "./dist/_official/index.mjs"
+    },
+    "./triggers": {
+      "types": "./dist/triggers.d.mts",
+      "default": "./dist/triggers.mjs"
+    },
+    "./capture": {
+      "types": "./dist/capture.d.mts",
+      "default": "./dist/capture.mjs"
+    },
+    "./decide": {
+      "types": "./dist/decide.d.mts",
+      "default": "./dist/decide.mjs"
+    },
+    "./feature-flags": {
+      "types": "./dist/feature-flags.d.mts",
+      "default": "./dist/feature-flags.mjs"
+    },
+    "./insights": {
+      "types": "./dist/insights.d.mts",
+      "default": "./dist/insights.mjs"
+    },
+    "./session-recordings": {
+      "types": "./dist/session-recordings.d.mts",
+      "default": "./dist/session-recordings.mjs"
+    },
+    "./surveys": {
+      "types": "./dist/surveys.d.mts",
+      "default": "./dist/surveys.mjs"
+    },
+    "./cohorts": {
+      "types": "./dist/cohorts.d.mts",
+      "default": "./dist/cohorts.mjs"
+    },
+    "./persons": {
+      "types": "./dist/persons.d.mts",
+      "default": "./dist/persons.mjs"
+    },
+    "./annotations": {
+      "types": "./dist/annotations.d.mts",
+      "default": "./dist/annotations.mjs"
+    },
+    "./dashboards": {
+      "types": "./dist/dashboards.d.mts",
+      "default": "./dist/dashboards.mjs"
+    },
+    "./events-management": {
+      "types": "./dist/events-management.d.mts",
+      "default": "./dist/events-management.mjs"
+    },
+    "./actions": {
+      "types": "./dist/actions.d.mts",
+      "default": "./dist/actions.mjs"
+    },
+    "./projects": {
+      "types": "./dist/projects.d.mts",
+      "default": "./dist/projects.mjs"
+    },
+    "./organizations": {
+      "types": "./dist/organizations.d.mts",
+      "default": "./dist/organizations.mjs"
+    },
+    "./webhook-management": {
+      "types": "./dist/webhook-management.d.mts",
+      "default": "./dist/webhook-management.mjs"
+    },
+    "./_runtime": {
+      "types": "./dist/_runtime/index.d.mts",
+      "default": "./dist/_runtime/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsgo --build",
+    "build": "tsdown",
+    "lint": "biome check .",
+    "test:unit": "vitest run --passWithNoTests --project unit",
+    "prepublishOnly": "pnpm build && pnpm test:unit",
+    "lint:fix": "biome check --write .",
+    "test:int": "vitest run --passWithNoTests --project int"
+  },
+  "dependencies": {
+    "@keystrokehq/integration-authoring": "^0.0.1",
+    "@keystrokehq/core": "^0.0.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "@keystrokehq/test-utils": "workspace:*",
+    "@keystrokehq/typescript-config": "workspace:*",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "keywords": [
+    "posthog",
+    "analytics",
+    "feature-flags",
+    "experiments",
+    "session-replay",
+    "keystroke",
+    "integration"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/keystrokehq/integrations",
+    "directory": "integrations/posthog"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}