@contractspec/example.integration-posthog 1.57.0 → 1.59.0

package/dist/run.js

@@ -1,12 +1,281 @@
-import { runPosthogExampleFromEnv } from "./posthog.js";
+// @bun
+// src/posthog.ts
+import { PosthogAnalyticsProvider } from "@contractspec/integration.providers-impls/impls/posthog";
+async function runPosthogExampleFromEnv() {
+  const mode = resolvePosthogMode();
+  const dryRun = resolveBooleanEnv("CONTRACTSPEC_POSTHOG_DRY_RUN", true);
+  const allowWrites = resolveBooleanEnv("CONTRACTSPEC_POSTHOG_ALLOW_WRITES", false);
+  const output = { mode, dryRun, allowWrites };
+  if (dryRun) {
+    if (mode === "capture" || mode === "all") {
+      output.capture = buildCapturePreview();
+    }
+    if (mode === "query" || mode === "all") {
+      output.query = { query: buildHogQLQuery() };
+    }
+    if (mode === "request" || mode === "all") {
+      output.request = buildRequestPreview();
+    }
+    if (mode === "read" || mode === "all") {
+      output.read = buildReadPreview();
+    }
+    if (process.env.POSTHOG_MCP_URL) {
+      output.mcp = buildMcpPreview();
+    }
+    return output;
+  }
+  const provider = createProviderFromEnv();
+  if (mode === "capture" || mode === "all") {
+    output.capture = await runCapture(provider, allowWrites);
+  }
+  if (mode === "query" || mode === "all") {
+    output.query = await runHogQLQuery(provider);
+  }
+  if (mode === "request" || mode === "all") {
+    output.request = await runApiRequests(provider, allowWrites);
+  }
+  if (mode === "read" || mode === "all") {
+    output.read = await runReadOperations(provider);
+  }
+  if (process.env.POSTHOG_MCP_URL) {
+    output.mcp = await runMcpToolCall(provider);
+  }
+  return output;
+}
+function resolvePosthogMode() {
+  const raw = (process.env.CONTRACTSPEC_POSTHOG_MODE ?? "all").toLowerCase();
+  if (raw === "capture" || raw === "query" || raw === "request" || raw === "read" || raw === "all") {
+    return raw;
+  }
+  throw new Error(`Unsupported CONTRACTSPEC_POSTHOG_MODE: ${raw}. Use capture, query, request, read, or all.`);
+}
+function createProviderFromEnv() {
+  return new PosthogAnalyticsProvider({
+    host: process.env.POSTHOG_HOST,
+    projectId: process.env.POSTHOG_PROJECT_ID,
+    projectApiKey: process.env.POSTHOG_PROJECT_API_KEY,
+    personalApiKey: process.env.POSTHOG_PERSONAL_API_KEY,
+    mcpUrl: process.env.POSTHOG_MCP_URL,
+    requestTimeoutMs: 1e4
+  });
+}
+async function runCapture(provider, allowWrites) {
+  if (!allowWrites) {
+    return {
+      skipped: true,
+      reason: "Set CONTRACTSPEC_POSTHOG_ALLOW_WRITES=true to enable capture."
+    };
+  }
+  const event = buildCaptureEvent();
+  if (provider.identify) {
+    await provider.identify({
+      distinctId: event.distinctId,
+      properties: { plan: "pro", source: "contractspec-example" }
+    });
+  }
+  await provider.capture(event);
+  return { captured: true, event };
+}
+async function runHogQLQuery(provider) {
+  if (!provider.queryHogQL) {
+    throw new Error("Analytics provider does not support HogQL queries.");
+  }
+  const query = buildHogQLQuery();
+  return provider.queryHogQL({ query });
+}
+async function runApiRequests(provider, allowWrites) {
+  const projectId = requireEnv("POSTHOG_PROJECT_ID");
+  const listRequest = {
+    method: "GET",
+    path: `/api/projects/${projectId}/feature_flags/`,
+    query: { limit: 5 }
+  };
+  const listResponse = await provider.request(listRequest);
+  const output = {
+    list: listResponse.data
+  };
+  if (!allowWrites) {
+    output.writeGuard = "Set CONTRACTSPEC_POSTHOG_ALLOW_WRITES=true to create/delete feature flags.";
+    return output;
+  }
+  const flagKey = `contractspec-example-${Date.now()}`;
+  const createResponse = await provider.request({
+    method: "POST",
+    path: `/api/projects/${projectId}/feature_flags/`,
+    body: {
+      name: "ContractSpec Example Flag",
+      key: flagKey,
+      active: true,
+      filters: {
+        groups: [
+          {
+            properties: [],
+            rollout_percentage: 100
+          }
+        ]
+      }
+    }
+  });
+  output.created = createResponse.data;
+  const createdId = extractId(createResponse);
+  if (createdId) {
+    const deleteResponse = await provider.request({
+      method: "DELETE",
+      path: `/api/projects/${projectId}/feature_flags/${createdId}`
+    });
+    output.deleted = deleteResponse.status;
+  } else {
+    output.deleted = "Skipped delete: response did not include an id.";
+  }
+  return output;
+}
+async function runReadOperations(provider) {
+  const now = new Date;
+  const from = new Date(now.getTime() - 24 * 60 * 60 * 1000);
+  const dateRange = { from, to: now };
+  const output = {
+    window: { from: from.toISOString(), to: now.toISOString() }
+  };
+  if (provider.getEvents) {
+    output.events = await provider.getEvents({ dateRange, limit: 5 });
+  } else {
+    output.events = "Provider does not support getEvents.";
+  }
+  if (provider.getPersons) {
+    output.persons = await provider.getPersons({ limit: 5 });
+  } else {
+    output.persons = "Provider does not support getPersons.";
+  }
+  if (provider.getInsights) {
+    output.insights = await provider.getInsights({ limit: 5 });
+  } else {
+    output.insights = "Provider does not support getInsights.";
+  }
+  if (provider.getFeatureFlags) {
+    output.featureFlags = await provider.getFeatureFlags({ limit: 5 });
+  } else {
+    output.featureFlags = "Provider does not support getFeatureFlags.";
+  }
+  return output;
+}
+async function runMcpToolCall(provider) {
+  if (!provider.callMcpTool) {
+    throw new Error("Analytics provider does not support MCP tool calls.");
+  }
+  const name = process.env.POSTHOG_MCP_TOOL_NAME ?? "posthog.query";
+  const argumentsValue = parseOptionalJsonEnv("POSTHOG_MCP_TOOL_ARGS", {
+    query: buildHogQLQuery()
+  });
+  return provider.callMcpTool({ name, arguments: argumentsValue });
+}
+function buildCaptureEvent() {
+  const distinctId = process.env.POSTHOG_DISTINCT_ID ?? "contractspec-demo";
+  const event = process.env.POSTHOG_EVENT_NAME ?? "contractspec.example.event";
+  return {
+    distinctId,
+    event,
+    properties: {
+      source: "contractspec-example",
+      environment: "development"
+    },
+    timestamp: new Date
+  };
+}
+function buildHogQLQuery() {
+  return "select event, count() as count " + "from events " + "where timestamp >= now() - interval 1 day " + "group by event " + "order by count desc " + "limit 5";
+}
+function buildCapturePreview() {
+  return {
+    event: buildCaptureEvent(),
+    hint: "Dry run enabled. Set CONTRACTSPEC_POSTHOG_DRY_RUN=false."
+  };
+}
+function buildRequestPreview() {
+  const projectId = process.env.POSTHOG_PROJECT_ID ?? "PROJECT_ID";
+  return {
+    listRequest: {
+      method: "GET",
+      path: `/api/projects/${projectId}/feature_flags/`,
+      query: { limit: 5 }
+    },
+    writeRequests: {
+      create: {
+        method: "POST",
+        path: `/api/projects/${projectId}/feature_flags/`
+      },
+      delete: {
+        method: "DELETE",
+        path: `/api/projects/${projectId}/feature_flags/{id}`
+      }
+    }
+  };
+}
+function buildReadPreview() {
+  return {
+    events: {
+      dateRange: "last_24_hours",
+      limit: 5
+    },
+    persons: {
+      limit: 5
+    },
+    insights: {
+      limit: 5
+    },
+    featureFlags: {
+      limit: 5
+    }
+  };
+}
+function buildMcpPreview() {
+  return {
+    url: process.env.POSTHOG_MCP_URL,
+    toolName: process.env.POSTHOG_MCP_TOOL_NAME ?? "posthog.query",
+    arguments: parseOptionalJsonEnv("POSTHOG_MCP_TOOL_ARGS", {
+      query: buildHogQLQuery()
+    })
+  };
+}
+function extractId(response) {
+  if (!response || typeof response !== "object")
+    return null;
+  const data = response.data;
+  if (data && (typeof data.id === "string" || typeof data.id === "number")) {
+    return data.id;
+  }
+  return null;
+}
+function resolveBooleanEnv(key, defaultValue) {
+  const value = process.env[key];
+  if (value === undefined)
+    return defaultValue;
+  return value.toLowerCase() === "true";
+}
+function requireEnv(key) {
+  const value = process.env[key];
+  if (!value) {
+    throw new Error(`Missing required env var: ${key}`);
+  }
+  return value;
+}
+function parseOptionalJsonEnv(key, fallback) {
+  const raw = process.env[key];
+  if (!raw)
+    return fallback;
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object")
+      return parsed;
+  } catch {
+    throw new Error(`Invalid JSON in ${key}`);
+  }
+  return fallback;
+}
 
-//#region src/run.ts
+// src/run.ts
 runPosthogExampleFromEnv().then((result) => {
-	console.log(JSON.stringify(result, null, 2));
+  console.log(JSON.stringify(result, null, 2));
 }).catch((error) => {
-	console.error(error);
-	process.exitCode = 1;
+  console.error(error);
+  process.exitCode = 1;
 });
-
-//#endregion
-//# sourceMappingURL=run.js.map

package/package.json

@@ -1,51 +1,94 @@
 {
   "name": "@contractspec/example.integration-posthog",
-  "version": "1.57.0",
+  "version": "1.59.0",
   "description": "PostHog analytics integration example: capture events, run HogQL, and manage feature flags.",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./docs": "./dist/docs/index.js",
-    "./docs/integration-posthog.docblock": "./dist/docs/integration-posthog.docblock.js",
-    "./example": "./dist/example.js",
-    "./posthog": "./dist/posthog.js",
-    "./run": "./dist/run.js",
-    "./*": "./*"
+    ".": "./src/index.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/index": "./src/docs/index.ts",
+    "./docs/integration-posthog.docblock": "./src/docs/integration-posthog.docblock.ts",
+    "./example": "./src/example.ts",
+    "./posthog": "./src/posthog.ts",
+    "./run": "./src/run.ts"
   },
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun test"
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/integration.providers-impls": "1.57.0",
-    "@contractspec/lib.contracts": "1.57.0"
+    "@contractspec/integration.providers-impls": "1.59.0",
+    "@contractspec/lib.contracts": "1.59.0"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.57.0",
-    "@contractspec/tool.typescript": "1.57.0",
-    "tsdown": "^0.20.3",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.typescript": "1.59.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "1.58.0"
   },
   "publishConfig": {
     "access": "public",
     "exports": {
-      ".": "./dist/index.js",
-      "./docs": "./dist/docs/index.js",
-      "./docs/integration-posthog.docblock": "./dist/docs/integration-posthog.docblock.js",
-      "./example": "./dist/example.js",
-      "./posthog": "./dist/posthog.js",
-      "./run": "./dist/run.js",
-      "./*": "./*"
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "browser": "./dist/browser/index.js",
+        "default": "./dist/index.js"
+      },
+      "./docs": {
+        "types": "./dist/docs/index.d.ts",
+        "bun": "./dist/docs/index.js",
+        "node": "./dist/node/docs/index.mjs",
+        "browser": "./dist/browser/docs/index.js",
+        "default": "./dist/docs/index.js"
+      },
+      "./docs/index": {
+        "types": "./dist/docs/index.d.ts",
+        "bun": "./dist/docs/index.js",
+        "node": "./dist/node/docs/index.mjs",
+        "browser": "./dist/browser/docs/index.js",
+        "default": "./dist/docs/index.js"
+      },
+      "./docs/integration-posthog.docblock": {
+        "types": "./dist/docs/integration-posthog.docblock.d.ts",
+        "bun": "./dist/docs/integration-posthog.docblock.js",
+        "node": "./dist/node/docs/integration-posthog.docblock.mjs",
+        "browser": "./dist/browser/docs/integration-posthog.docblock.js",
+        "default": "./dist/docs/integration-posthog.docblock.js"
+      },
+      "./example": {
+        "types": "./dist/example.d.ts",
+        "bun": "./dist/example.js",
+        "node": "./dist/node/example.mjs",
+        "browser": "./dist/browser/example.js",
+        "default": "./dist/example.js"
+      },
+      "./posthog": {
+        "types": "./dist/posthog.d.ts",
+        "bun": "./dist/posthog.js",
+        "node": "./dist/node/posthog.mjs",
+        "browser": "./dist/browser/posthog.js",
+        "default": "./dist/posthog.js"
+      },
+      "./run": {
+        "types": "./dist/run.d.ts",
+        "bun": "./dist/run.js",
+        "node": "./dist/node/run.mjs",
+        "browser": "./dist/browser/run.js",
+        "default": "./dist/run.js"
+      }
     },
     "registry": "https://registry.npmjs.org/"
   },

package/tsdown.config.js

@@ -1,5 +1,4 @@
-import { defineConfig } from 'tsdown';
-import { moduleLibrary } from '@contractspec/tool.tsdown';
+import { defineConfig, moduleLibrary } from '@contractspec/tool.bun';
 
 export default defineConfig(() => ({
   ...moduleLibrary,

package/.turbo/turbo-build$colon$bundle.log

@@ -1,33 +0,0 @@
-$ tsdown
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/integration-posthog/tsdown.config.js 
-ℹ entry: src/example.ts, src/index.ts, src/posthog.ts, src/run.ts, src/docs/index.ts, src/docs/integration-posthog.docblock.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ Cleaning 19 files
-ℹ dist/posthog.js                                 7.59 kB │ gzip: 2.32 kB
-ℹ dist/docs/integration-posthog.docblock.js       1.97 kB │ gzip: 0.94 kB
-ℹ dist/example.js                                 0.99 kB │ gzip: 0.52 kB
-ℹ dist/run.js                                     0.29 kB │ gzip: 0.22 kB
-ℹ dist/index.js                                   0.20 kB │ gzip: 0.13 kB
-ℹ dist/docs/index.js                              0.04 kB │ gzip: 0.06 kB
-ℹ dist/posthog.js.map                            14.43 kB │ gzip: 4.14 kB
-ℹ dist/docs/integration-posthog.docblock.js.map   2.50 kB │ gzip: 1.13 kB
-ℹ dist/example.js.map                             1.46 kB │ gzip: 0.71 kB
-ℹ dist/run.js.map                                 0.49 kB │ gzip: 0.33 kB
-ℹ dist/posthog.d.ts.map                           0.33 kB │ gzip: 0.21 kB
-ℹ dist/example.d.ts.map                           0.13 kB │ gzip: 0.13 kB
-ℹ dist/posthog.d.ts                               0.74 kB │ gzip: 0.36 kB
-ℹ dist/index.d.ts                                 0.26 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts                               0.25 kB │ gzip: 0.17 kB
-ℹ dist/docs/index.d.ts                            0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/integration-posthog.docblock.d.ts     0.01 kB │ gzip: 0.03 kB
-ℹ dist/run.d.ts                                   0.01 kB │ gzip: 0.03 kB
-ℹ 18 files, total: 31.72 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - rolldown-plugin-dts:generate (56%)
-  - tsdown:external (42%)
-See https://rolldown.rs/options/checks#plugintimings for more details.
-
-✔ Build complete in 19320ms

package/dist/docs/integration-posthog.docblock.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"integration-posthog.docblock.js","names":[],"sources":["../../src/docs/integration-posthog.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst blocks: DocBlock[] = [\n  {\n    id: 'docs.examples.integration-posthog',\n    title: 'Integration Example — PostHog Analytics',\n    summary:\n      'Capture events, run HogQL, and manage feature flags using the PostHog analytics provider.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/integration-posthog',\n    tags: ['posthog', 'analytics', 'hogql', 'example'],\n    body: `## What this example shows\n- Capture product events and identify users.\n- Run HogQL queries through the analytics provider.\n- Perform generic REST API requests (feature flag list/create/delete).\n- Read events, persons, insights, and feature flags using typed reader methods.\n- Optionally call a PostHog MCP tool via JSON-RPC.\n\n## Guardrails\n- Use dry-run while validating credentials.\n- Writes are gated behind CONTRACTSPEC_POSTHOG_ALLOW_WRITES.\n- Keep API keys in secret storage.`,\n  },\n  {\n    id: 'docs.examples.integration-posthog.usage',\n    title: 'PostHog Integration Example — Usage',\n    summary: 'How to run the PostHog example with env-driven settings.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/integration-posthog/usage',\n    tags: ['posthog', 'usage'],\n    body: `## Usage\n- Set CONTRACTSPEC_POSTHOG_MODE to capture | query | request | read | all.\n- Set CONTRACTSPEC_POSTHOG_DRY_RUN=true for a safe preview.\n- Set CONTRACTSPEC_POSTHOG_ALLOW_WRITES=true to enable capture and create/delete.\n\n## Required env vars\n- POSTHOG_PROJECT_ID for queries and REST requests.\n- POSTHOG_PROJECT_API_KEY for capture/identify.\n- POSTHOG_PERSONAL_API_KEY for HogQL queries and REST requests.\n\n## MCP\n- Set POSTHOG_MCP_URL to call tools/call.\n- Optionally set POSTHOG_MCP_TOOL_NAME and POSTHOG_MCP_TOOL_ARGS (JSON).\n\n## Example\n- Call runPosthogExampleFromEnv() from run.ts to execute the flow.`,\n  },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AAoDA,kBAjD2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAW;EAAa;EAAS;EAAU;CAClD,MAAM;;;;;;;;;;;CAWP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,WAAW,QAAQ;CAC1B,MAAM;;;;;;;;;;;;;;;;CAgBP,CACF,CAEwB"}

package/dist/example.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'integration-posthog',\n    version: '1.0.0',\n    title: 'Integration — PostHog Analytics',\n    description:\n      'Capture events, run HogQL, and manage PostHog assets via AnalyticsProvider.',\n    kind: 'integration',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.integrations'],\n    tags: ['posthog', 'analytics', 'hogql', 'integration'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.integration-posthog',\n    usageDocId: 'docs.examples.integration-posthog.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.integration-posthog',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,yBAAyB;EAClC,MAAM;GAAC;GAAW;GAAa;GAAS;GAAc;EACvD;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC"}

package/dist/posthog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"posthog.js","names":[],"sources":["../src/posthog.ts"],"sourcesContent":["import { PosthogAnalyticsProvider } from '@contractspec/integration.providers-impls/impls/posthog';\nimport type {\n  AnalyticsEventInput,\n  AnalyticsProvider,\n  AnalyticsQueryResult,\n  AnalyticsRequest,\n  AnalyticsResponse,\n} from '@contractspec/integration.providers-impls/analytics';\n\nexport type PosthogExampleMode =\n  | 'capture'\n  | 'query'\n  | 'request'\n  | 'read'\n  | 'all';\n\nexport interface PosthogExampleOutput {\n  mode: PosthogExampleMode;\n  dryRun: boolean;\n  allowWrites: boolean;\n  capture?: unknown;\n  query?: AnalyticsQueryResult | unknown;\n  request?: Record<string, unknown>;\n  read?: Record<string, unknown>;\n  mcp?: unknown;\n}\n\nexport async function runPosthogExampleFromEnv(): Promise<PosthogExampleOutput> {\n  const mode = resolvePosthogMode();\n  const dryRun = resolveBooleanEnv('CONTRACTSPEC_POSTHOG_DRY_RUN', true);\n  const allowWrites = resolveBooleanEnv(\n    'CONTRACTSPEC_POSTHOG_ALLOW_WRITES',\n    false\n  );\n  const output: PosthogExampleOutput = { mode, dryRun, allowWrites };\n\n  if (dryRun) {\n    if (mode === 'capture' || mode === 'all') {\n      output.capture = buildCapturePreview();\n    }\n    if (mode === 'query' || mode === 'all') {\n      output.query = { query: buildHogQLQuery() };\n    }\n    if (mode === 'request' || mode === 'all') {\n      output.request = buildRequestPreview();\n    }\n    if (mode === 'read' || mode === 'all') {\n      output.read = buildReadPreview();\n    }\n    if (process.env.POSTHOG_MCP_URL) {\n      output.mcp = buildMcpPreview();\n    }\n    return output;\n  }\n\n  const provider = createProviderFromEnv();\n\n  if (mode === 'capture' || mode === 'all') {\n    output.capture = await runCapture(provider, allowWrites);\n  }\n\n  if (mode === 'query' || mode === 'all') {\n    output.query = await runHogQLQuery(provider);\n  }\n\n  if (mode === 'request' || mode === 'all') {\n    output.request = await runApiRequests(provider, allowWrites);\n  }\n\n  if (mode === 'read' || mode === 'all') {\n    output.read = await runReadOperations(provider);\n  }\n\n  if (process.env.POSTHOG_MCP_URL) {\n    output.mcp = await runMcpToolCall(provider);\n  }\n\n  return output;\n}\n\nexport function resolvePosthogMode(): PosthogExampleMode {\n  const raw = (process.env.CONTRACTSPEC_POSTHOG_MODE ?? 'all').toLowerCase();\n  if (\n    raw === 'capture' ||\n    raw === 'query' ||\n    raw === 'request' ||\n    raw === 'read' ||\n    raw === 'all'\n  ) {\n    return raw;\n  }\n  throw new Error(\n    `Unsupported CONTRACTSPEC_POSTHOG_MODE: ${raw}. Use capture, query, request, read, or all.`\n  );\n}\n\nfunction createProviderFromEnv(): AnalyticsProvider {\n  return new PosthogAnalyticsProvider({\n    host: process.env.POSTHOG_HOST,\n    projectId: process.env.POSTHOG_PROJECT_ID,\n    projectApiKey: process.env.POSTHOG_PROJECT_API_KEY,\n    personalApiKey: process.env.POSTHOG_PERSONAL_API_KEY,\n    mcpUrl: process.env.POSTHOG_MCP_URL,\n    requestTimeoutMs: 10000,\n  });\n}\n\nasync function runCapture(\n  provider: AnalyticsProvider,\n  allowWrites: boolean\n): Promise<Record<string, unknown>> {\n  if (!allowWrites) {\n    return {\n      skipped: true,\n      reason: 'Set CONTRACTSPEC_POSTHOG_ALLOW_WRITES=true to enable capture.',\n    };\n  }\n\n  const event = buildCaptureEvent();\n  if (provider.identify) {\n    await provider.identify({\n      distinctId: event.distinctId,\n      properties: { plan: 'pro', source: 'contractspec-example' },\n    });\n  }\n  await provider.capture(event);\n  return { captured: true, event };\n}\n\nasync function runHogQLQuery(\n  provider: AnalyticsProvider\n): Promise<AnalyticsQueryResult> {\n  if (!provider.queryHogQL) {\n    throw new Error('Analytics provider does not support HogQL queries.');\n  }\n  const query = buildHogQLQuery();\n  return provider.queryHogQL({ query });\n}\n\nasync function runApiRequests(\n  provider: AnalyticsProvider,\n  allowWrites: boolean\n): Promise<Record<string, unknown>> {\n  const projectId = requireEnv('POSTHOG_PROJECT_ID');\n  const listRequest: AnalyticsRequest = {\n    method: 'GET',\n    path: `/api/projects/${projectId}/feature_flags/`,\n    query: { limit: 5 },\n  };\n  const listResponse = await provider.request(listRequest);\n  const output: Record<string, unknown> = {\n    list: listResponse.data,\n  };\n\n  if (!allowWrites) {\n    output.writeGuard =\n      'Set CONTRACTSPEC_POSTHOG_ALLOW_WRITES=true to create/delete feature flags.';\n    return output;\n  }\n\n  const flagKey = `contractspec-example-${Date.now()}`;\n  const createResponse = await provider.request({\n    method: 'POST',\n    path: `/api/projects/${projectId}/feature_flags/`,\n    body: {\n      name: 'ContractSpec Example Flag',\n      key: flagKey,\n      active: true,\n      filters: {\n        groups: [\n          {\n            properties: [],\n            rollout_percentage: 100,\n          },\n        ],\n      },\n    },\n  });\n  output.created = createResponse.data;\n\n  const createdId = extractId(createResponse);\n  if (createdId) {\n    const deleteResponse = await provider.request({\n      method: 'DELETE',\n      path: `/api/projects/${projectId}/feature_flags/${createdId}`,\n    });\n    output.deleted = deleteResponse.status;\n  } else {\n    output.deleted = 'Skipped delete: response did not include an id.';\n  }\n\n  return output;\n}\n\nasync function runReadOperations(\n  provider: AnalyticsProvider\n): Promise<Record<string, unknown>> {\n  const now = new Date();\n  const from = new Date(now.getTime() - 24 * 60 * 60 * 1000);\n  const dateRange = { from, to: now };\n  const output: Record<string, unknown> = {\n    window: { from: from.toISOString(), to: now.toISOString() },\n  };\n\n  if (provider.getEvents) {\n    output.events = await provider.getEvents({ dateRange, limit: 5 });\n  } else {\n    output.events = 'Provider does not support getEvents.';\n  }\n\n  if (provider.getPersons) {\n    output.persons = await provider.getPersons({ limit: 5 });\n  } else {\n    output.persons = 'Provider does not support getPersons.';\n  }\n\n  if (provider.getInsights) {\n    output.insights = await provider.getInsights({ limit: 5 });\n  } else {\n    output.insights = 'Provider does not support getInsights.';\n  }\n\n  if (provider.getFeatureFlags) {\n    output.featureFlags = await provider.getFeatureFlags({ limit: 5 });\n  } else {\n    output.featureFlags = 'Provider does not support getFeatureFlags.';\n  }\n\n  return output;\n}\n\nasync function runMcpToolCall(provider: AnalyticsProvider): Promise<unknown> {\n  if (!provider.callMcpTool) {\n    throw new Error('Analytics provider does not support MCP tool calls.');\n  }\n  const name = process.env.POSTHOG_MCP_TOOL_NAME ?? 'posthog.query';\n  const argumentsValue = parseOptionalJsonEnv('POSTHOG_MCP_TOOL_ARGS', {\n    query: buildHogQLQuery(),\n  });\n  return provider.callMcpTool({ name, arguments: argumentsValue });\n}\n\nfunction buildCaptureEvent(): AnalyticsEventInput {\n  const distinctId = process.env.POSTHOG_DISTINCT_ID ?? 'contractspec-demo';\n  const event = process.env.POSTHOG_EVENT_NAME ?? 'contractspec.example.event';\n  return {\n    distinctId,\n    event,\n    properties: {\n      source: 'contractspec-example',\n      environment: process.env.NODE_ENV ?? 'development',\n    },\n    timestamp: new Date(),\n  };\n}\n\nfunction buildHogQLQuery(): string {\n  return (\n    'select event, count() as count ' +\n    'from events ' +\n    'where timestamp >= now() - interval 1 day ' +\n    'group by event ' +\n    'order by count desc ' +\n    'limit 5'\n  );\n}\n\nfunction buildCapturePreview(): Record<string, unknown> {\n  return {\n    event: buildCaptureEvent(),\n    hint: 'Dry run enabled. Set CONTRACTSPEC_POSTHOG_DRY_RUN=false.',\n  };\n}\n\nfunction buildRequestPreview(): Record<string, unknown> {\n  const projectId = process.env.POSTHOG_PROJECT_ID ?? 'PROJECT_ID';\n  return {\n    listRequest: {\n      method: 'GET',\n      path: `/api/projects/${projectId}/feature_flags/`,\n      query: { limit: 5 },\n    },\n    writeRequests: {\n      create: {\n        method: 'POST',\n        path: `/api/projects/${projectId}/feature_flags/`,\n      },\n      delete: {\n        method: 'DELETE',\n        path: `/api/projects/${projectId}/feature_flags/{id}`,\n      },\n    },\n  };\n}\n\nfunction buildReadPreview(): Record<string, unknown> {\n  return {\n    events: {\n      dateRange: 'last_24_hours',\n      limit: 5,\n    },\n    persons: {\n      limit: 5,\n    },\n    insights: {\n      limit: 5,\n    },\n    featureFlags: {\n      limit: 5,\n    },\n  };\n}\n\nfunction buildMcpPreview(): Record<string, unknown> {\n  return {\n    url: process.env.POSTHOG_MCP_URL,\n    toolName: process.env.POSTHOG_MCP_TOOL_NAME ?? 'posthog.query',\n    arguments: parseOptionalJsonEnv('POSTHOG_MCP_TOOL_ARGS', {\n      query: buildHogQLQuery(),\n    }),\n  };\n}\n\nfunction extractId(\n  response: AnalyticsResponse<unknown>\n): string | number | null {\n  if (!response || typeof response !== 'object') return null;\n  const data = response.data as { id?: string | number } | null | undefined;\n  if (data && (typeof data.id === 'string' || typeof data.id === 'number')) {\n    return data.id;\n  }\n  return null;\n}\n\nfunction resolveBooleanEnv(key: string, defaultValue: boolean): boolean {\n  const value = process.env[key];\n  if (value === undefined) return defaultValue;\n  return value.toLowerCase() === 'true';\n}\n\nfunction requireEnv(key: string): string {\n  const value = process.env[key];\n  if (!value) {\n    throw new Error(`Missing required env var: ${key}`);\n  }\n  return value;\n}\n\nfunction parseOptionalJsonEnv(\n  key: string,\n  fallback: Record<string, unknown>\n): Record<string, unknown> {\n  const raw = process.env[key];\n  if (!raw) return fallback;\n  try {\n    const parsed = JSON.parse(raw) as Record<string, unknown>;\n    if (parsed && typeof parsed === 'object') return parsed;\n  } catch {\n    throw new Error(`Invalid JSON in ${key}`);\n  }\n  return fallback;\n}\n"],"mappings":"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"}

package/dist/run.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.js","names":[],"sources":["../src/run.ts"],"sourcesContent":["import { runPosthogExampleFromEnv } from './posthog';\n\nrunPosthogExampleFromEnv()\n  .then((result) => {\n    console.log(JSON.stringify(result, null, 2));\n  })\n  .catch((error) => {\n    console.error(error);\n    process.exitCode = 1;\n  });\n"],"mappings":";;;AAEA,0BAA0B,CACvB,MAAM,WAAW;AAChB,SAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,EAAE,CAAC;EAC5C,CACD,OAAO,UAAU;AAChB,SAAQ,MAAM,MAAM;AACpB,SAAQ,WAAW;EACnB"}