@contractspec/example.product-intent 1.57.0 → 1.59.0

package/dist/posthog-signals.js

@@ -1,205 +1,249 @@
-import { FunnelAnalyzer } from "./libs/analytics/dist/funnel/analyzer.js";
+// @bun
+// src/posthog-signals.ts
+import { FunnelAnalyzer } from "@contractspec/lib.analytics/funnel";
 import { PosthogAnalyticsProvider } from "@contractspec/integration.providers-impls/impls/posthog";
-
-//#region src/posthog-signals.ts
 async function loadPosthogEvidenceChunks(options) {
-	const chunks = [];
-	const range = resolveRange(options.dateRange);
-	const eventSummary = await loadEventSummary(options, range);
-	if (eventSummary) chunks.push(eventSummary);
-	const funnelEvidence = await loadFunnelEvidence(options, range);
-	if (funnelEvidence) chunks.push(funnelEvidence);
-	const featureFlags = await loadFeatureFlagEvidence(options);
-	if (featureFlags) chunks.push(featureFlags);
-	return chunks;
+  const chunks = [];
+  const range = resolveRange(options.dateRange);
+  const eventSummary = await loadEventSummary(options, range);
+  if (eventSummary) {
+    chunks.push(eventSummary);
+  }
+  const funnelEvidence = await loadFunnelEvidence(options, range);
+  if (funnelEvidence) {
+    chunks.push(funnelEvidence);
+  }
+  const featureFlags = await loadFeatureFlagEvidence(options);
+  if (featureFlags) {
+    chunks.push(featureFlags);
+  }
+  return chunks;
 }
 async function loadEventSummary(options, range) {
-	if (!options.reader.queryHogQL) return null;
-	const eventFilter = buildEventFilter(options.eventNames);
-	const limit = options.limit ?? 10;
-	const rows = mapRows(await options.reader.queryHogQL({
-		query: [
-			"select",
-			"  event as eventName,",
-			"  count() as total",
-			"from events",
-			"where timestamp >= {dateFrom} and timestamp < {dateTo}",
-			eventFilter.clause ? `and ${eventFilter.clause}` : "",
-			"group by eventName",
-			"order by total desc",
-			`limit ${limit}`
-		].filter(Boolean).join("\n"),
-		values: {
-			dateFrom: range.from.toISOString(),
-			dateTo: range.to.toISOString(),
-			...eventFilter.values
-		}
-	}));
-	if (rows.length === 0) return null;
-	const lines = rows.map((row) => {
-		return `- ${asString(row.eventName) ?? "unknown"}: ${asNumber(row.total)}`;
-	});
-	return {
-		chunkId: `posthog:event_summary:${range.from.toISOString()}`,
-		text: [`PostHog event summary (${range.from.toISOString()} → ${range.to.toISOString()}):`, ...lines].join("\n"),
-		meta: {
-			source: "posthog",
-			kind: "event_summary",
-			dateFrom: range.from.toISOString(),
-			dateTo: range.to.toISOString()
-		}
-	};
+  if (!options.reader.queryHogQL)
+    return null;
+  const eventFilter = buildEventFilter(options.eventNames);
+  const limit = options.limit ?? 10;
+  const result = await options.reader.queryHogQL({
+    query: [
+      "select",
+      "  event as eventName,",
+      "  count() as total",
+      "from events",
+      "where timestamp >= {dateFrom} and timestamp < {dateTo}",
+      eventFilter.clause ? `and ${eventFilter.clause}` : "",
+      "group by eventName",
+      "order by total desc",
+      `limit ${limit}`
+    ].filter(Boolean).join(`
+`),
+    values: {
+      dateFrom: range.from.toISOString(),
+      dateTo: range.to.toISOString(),
+      ...eventFilter.values
+    }
+  });
+  const rows = mapRows(result);
+  if (rows.length === 0)
+    return null;
+  const lines = rows.map((row) => {
+    const name = asString(row.eventName) ?? "unknown";
+    const total = asNumber(row.total);
+    return `- ${name}: ${total}`;
+  });
+  return {
+    chunkId: `posthog:event_summary:${range.from.toISOString()}`,
+    text: [
+      `PostHog event summary (${range.from.toISOString()} \u2192 ${range.to.toISOString()}):`,
+      ...lines
+    ].join(`
+`),
+    meta: {
+      source: "posthog",
+      kind: "event_summary",
+      dateFrom: range.from.toISOString(),
+      dateTo: range.to.toISOString()
+    }
+  };
 }
 async function loadFunnelEvidence(options, range) {
-	if (!options.funnel) return null;
-	if (!options.reader.getEvents) return null;
-	const events = [];
-	const eventNames = options.funnel.steps.map((step) => step.eventName);
-	for (const eventName of eventNames) (await options.reader.getEvents({
-		event: eventName,
-		dateRange: {
-			from: range.from,
-			to: range.to
-		},
-		limit: options.limit ?? 500
-	})).results.forEach((event) => {
-		events.push({
-			name: event.event,
-			userId: event.distinctId,
-			tenantId: typeof event.properties?.tenantId === "string" ? event.properties.tenantId : void 0,
-			timestamp: event.timestamp,
-			properties: event.properties
-		});
-	});
-	if (events.length === 0) return null;
-	const lines = new FunnelAnalyzer().analyze(events, options.funnel).steps.map((step) => {
-		return `- ${step.step.eventName}: ${step.count} (conversion ${step.conversionRate}, drop-off ${step.dropOffRate})`;
-	});
-	return {
-		chunkId: `posthog:funnel:${options.funnel.name}`,
-		text: [`PostHog funnel analysis — ${options.funnel.name}:`, ...lines].join("\n"),
-		meta: {
-			source: "posthog",
-			kind: "funnel",
-			funnelName: options.funnel.name,
-			dateFrom: range.from.toISOString(),
-			dateTo: range.to.toISOString()
-		}
-	};
+  if (!options.funnel)
+    return null;
+  if (!options.reader.getEvents)
+    return null;
+  const events = [];
+  const eventNames = options.funnel.steps.map((step) => step.eventName);
+  for (const eventName of eventNames) {
+    const response = await options.reader.getEvents({
+      event: eventName,
+      dateRange: {
+        from: range.from,
+        to: range.to
+      },
+      limit: options.limit ?? 500
+    });
+    response.results.forEach((event) => {
+      events.push({
+        name: event.event,
+        userId: event.distinctId,
+        tenantId: typeof event.properties?.tenantId === "string" ? event.properties.tenantId : undefined,
+        timestamp: event.timestamp,
+        properties: event.properties
+      });
+    });
+  }
+  if (events.length === 0)
+    return null;
+  const analyzer = new FunnelAnalyzer;
+  const analysis = analyzer.analyze(events, options.funnel);
+  const lines = analysis.steps.map((step) => {
+    return `- ${step.step.eventName}: ${step.count} (conversion ${step.conversionRate}, drop-off ${step.dropOffRate})`;
+  });
+  return {
+    chunkId: `posthog:funnel:${options.funnel.name}`,
+    text: [`PostHog funnel analysis \u2014 ${options.funnel.name}:`, ...lines].join(`
+`),
+    meta: {
+      source: "posthog",
+      kind: "funnel",
+      funnelName: options.funnel.name,
+      dateFrom: range.from.toISOString(),
+      dateTo: range.to.toISOString()
+    }
+  };
 }
 async function loadFeatureFlagEvidence(options) {
-	if (!options.includeFeatureFlags) return null;
-	if (!options.reader.getFeatureFlags) return null;
-	const response = await options.reader.getFeatureFlags({ limit: 10 });
-	if (!response.results.length) return null;
-	return {
-		chunkId: "posthog:feature_flags",
-		text: ["PostHog feature flags:", ...response.results.map((flag) => {
-			return `- ${flag.key ?? "unknown"}: ${flag.active ? "active" : "inactive"}`;
-		})].join("\n"),
-		meta: {
-			source: "posthog",
-			kind: "feature_flags"
-		}
-	};
+  if (!options.includeFeatureFlags)
+    return null;
+  if (!options.reader.getFeatureFlags)
+    return null;
+  const response = await options.reader.getFeatureFlags({ limit: 10 });
+  if (!response.results.length)
+    return null;
+  const lines = response.results.map((flag) => {
+    const key = flag.key ?? "unknown";
+    const active = flag.active ? "active" : "inactive";
+    return `- ${key}: ${active}`;
+  });
+  return {
+    chunkId: "posthog:feature_flags",
+    text: ["PostHog feature flags:", ...lines].join(`
+`),
+    meta: {
+      source: "posthog",
+      kind: "feature_flags"
+    }
+  };
 }
 function resolveRange(dateRange) {
-	const now = /* @__PURE__ */ new Date();
-	return {
-		from: dateRange?.from instanceof Date ? dateRange.from : dateRange?.from ? new Date(dateRange.from) : /* @__PURE__ */ new Date(now.getTime() - 720 * 60 * 60 * 1e3),
-		to: dateRange?.to instanceof Date ? dateRange.to : dateRange?.to ? new Date(dateRange.to) : now
-	};
+  const now = new Date;
+  const from = dateRange?.from instanceof Date ? dateRange.from : dateRange?.from ? new Date(dateRange.from) : new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+  const to = dateRange?.to instanceof Date ? dateRange.to : dateRange?.to ? new Date(dateRange.to) : now;
+  return { from, to };
 }
 function buildEventFilter(eventNames) {
-	if (!eventNames || eventNames.length === 0) return {};
-	if (eventNames.length === 1) return {
-		clause: "event = {event0}",
-		values: { event0: eventNames[0] }
-	};
-	const values = {};
-	return {
-		clause: `(${eventNames.map((eventName, index) => {
-			values[`event${index}`] = eventName;
-			return `event = {event${index}}`;
-		}).join(" or ")})`,
-		values
-	};
+  if (!eventNames || eventNames.length === 0)
+    return {};
+  if (eventNames.length === 1) {
+    return {
+      clause: "event = {event0}",
+      values: { event0: eventNames[0] }
+    };
+  }
+  const values = {};
+  const clauses = eventNames.map((eventName, index) => {
+    values[`event${index}`] = eventName;
+    return `event = {event${index}}`;
+  });
+  return {
+    clause: `(${clauses.join(" or ")})`,
+    values
+  };
 }
 function mapRows(result) {
-	if (!Array.isArray(result.results) || !Array.isArray(result.columns)) return [];
-	const columns = result.columns;
-	return result.results.flatMap((row) => {
-		if (!Array.isArray(row)) return [];
-		const record = {};
-		columns.forEach((column, index) => {
-			record[column] = row[index];
-		});
-		return [record];
-	});
+  if (!Array.isArray(result.results) || !Array.isArray(result.columns)) {
+    return [];
+  }
+  const columns = result.columns;
+  return result.results.flatMap((row) => {
+    if (!Array.isArray(row))
+      return [];
+    const record = {};
+    columns.forEach((column, index) => {
+      record[column] = row[index];
+    });
+    return [record];
+  });
 }
 function asString(value) {
-	if (typeof value === "string" && value.trim()) return value;
-	if (typeof value === "number") return String(value);
-	return null;
+  if (typeof value === "string" && value.trim())
+    return value;
+  if (typeof value === "number")
+    return String(value);
+  return null;
 }
 function asNumber(value) {
-	if (typeof value === "number" && Number.isFinite(value)) return value;
-	if (typeof value === "string" && value.trim()) {
-		const parsed = Number(value);
-		if (Number.isFinite(parsed)) return parsed;
-	}
-	return 0;
+  if (typeof value === "number" && Number.isFinite(value))
+    return value;
+  if (typeof value === "string" && value.trim()) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed))
+      return parsed;
+  }
+  return 0;
 }
 function resolvePosthogEvidenceOptionsFromEnv(options = {}) {
-	const projectId = process.env.POSTHOG_PROJECT_ID;
-	const personalApiKey = process.env.POSTHOG_PERSONAL_API_KEY;
-	if (!projectId || !personalApiKey) return null;
-	const lookbackDays = resolveNumberEnv("POSTHOG_EVIDENCE_LOOKBACK_DAYS", options.defaultLookbackDays ?? 30);
-	const limit = resolveNumberEnv("POSTHOG_EVIDENCE_LIMIT", options.defaultLimit ?? 10);
-	const now = /* @__PURE__ */ new Date();
-	const from = /* @__PURE__ */ new Date(now.getTime() - lookbackDays * 24 * 60 * 60 * 1e3);
-	const eventNames = resolveCsvEnv("POSTHOG_EVIDENCE_EVENTS");
-	const funnelSteps = resolveCsvEnv("POSTHOG_EVIDENCE_FUNNEL_STEPS");
-	const funnel = funnelSteps && funnelSteps.length ? {
-		name: "posthog-evidence-funnel",
-		steps: funnelSteps.map((eventName, index) => ({
-			id: `step_${index + 1}`,
-			eventName
-		}))
-	} : void 0;
-	return {
-		reader: new PosthogAnalyticsProvider({
-			host: process.env.POSTHOG_HOST,
-			projectId,
-			personalApiKey
-		}),
-		dateRange: {
-			from,
-			to: now
-		},
-		eventNames,
-		limit,
-		funnel,
-		includeFeatureFlags: resolveBooleanEnv("POSTHOG_EVIDENCE_FEATURE_FLAGS", true)
-	};
+  const projectId = process.env.POSTHOG_PROJECT_ID;
+  const personalApiKey = process.env.POSTHOG_PERSONAL_API_KEY;
+  if (!projectId || !personalApiKey)
+    return null;
+  const lookbackDays = resolveNumberEnv("POSTHOG_EVIDENCE_LOOKBACK_DAYS", options.defaultLookbackDays ?? 30);
+  const limit = resolveNumberEnv("POSTHOG_EVIDENCE_LIMIT", options.defaultLimit ?? 10);
+  const now = new Date;
+  const from = new Date(now.getTime() - lookbackDays * 24 * 60 * 60 * 1000);
+  const eventNames = resolveCsvEnv("POSTHOG_EVIDENCE_EVENTS");
+  const funnelSteps = resolveCsvEnv("POSTHOG_EVIDENCE_FUNNEL_STEPS");
+  const funnel = funnelSteps && funnelSteps.length ? {
+    name: "posthog-evidence-funnel",
+    steps: funnelSteps.map((eventName, index) => ({
+      id: `step_${index + 1}`,
+      eventName
+    }))
+  } : undefined;
+  const reader = new PosthogAnalyticsProvider({
+    host: process.env.POSTHOG_HOST,
+    projectId,
+    personalApiKey
+  });
+  return {
+    reader,
+    dateRange: { from, to: now },
+    eventNames,
+    limit,
+    funnel,
+    includeFeatureFlags: resolveBooleanEnv("POSTHOG_EVIDENCE_FEATURE_FLAGS", true)
+  };
 }
 function resolveCsvEnv(key) {
-	const value = process.env[key];
-	if (!value) return void 0;
-	return value.split(",").map((item) => item.trim()).filter(Boolean);
+  const value = process.env[key];
+  if (!value)
+    return;
+  return value.split(",").map((item) => item.trim()).filter(Boolean);
 }
 function resolveNumberEnv(key, fallback) {
-	const value = process.env[key];
-	if (!value) return fallback;
-	const parsed = Number(value);
-	return Number.isFinite(parsed) ? parsed : fallback;
+  const value = process.env[key];
+  if (!value)
+    return fallback;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : fallback;
 }
 function resolveBooleanEnv(key, fallback) {
-	const value = process.env[key];
-	if (value === void 0) return fallback;
-	return value.toLowerCase() === "true";
+  const value = process.env[key];
+  if (value === undefined)
+    return fallback;
+  return value.toLowerCase() === "true";
 }
-
-//#endregion
-export { loadPosthogEvidenceChunks, resolvePosthogEvidenceOptionsFromEnv };
-//# sourceMappingURL=posthog-signals.js.map
+export {
+  resolvePosthogEvidenceOptionsFromEnv,
+  loadPosthogEvidenceChunks
+};

package/dist/script.d.ts

@@ -1 +1,2 @@
-export { };
+export {};
+//# sourceMappingURL=script.d.ts.map

package/dist/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../src/script.ts"],"names":[],"mappings":""}