@posthog/ai 8.13.5 → 8.13.7

package/dist/index.d.ts

@@ -115,6 +115,11 @@ interface ClientOptions {
 declare const wrapVercelLanguageModel: <T extends LanguageModel>(model: T, phClient: PostHog, options: ClientOptions) => T;
 //#endregion
 //#region src/prompts.d.ts
+/** Carries the server's own cooldown so a rate-limited client waits as long as it was told to. */
+declare class PromptFetchError extends Error {
+  readonly retryAfterSeconds?: number;
+  constructor(message: string, retryAfterSeconds?: number);
+}
 interface PromptsWithPostHogOptions {
   posthog: PostHog;
   defaultCacheTtlSeconds?: number;
@@ -170,6 +175,7 @@ declare class Prompts {
   private host;
   private defaultCacheTtlSeconds;
   private cache;
+  private inFlight;
   constructor(options: PromptsOptions);
   private getPromptCache;
   private getOrCreatePromptCache;
@@ -212,6 +218,7 @@ declare class Prompts {
    * Does NOT handle the string `fallback` option — callers handle that.
    */
   private getInternal;
+  private fetchPromptOnce;
   private readCacheEntry;
   /**
    * Compile a prompt template with variable substitution
@@ -331,5 +338,5 @@ interface CaptureAiGenerationOptions {
  */
 declare const captureAiGeneration: (client: PostHog, options: CaptureAiGenerationOptions) => Promise<void>;
 //#endregion
-export { AIEvent, type CaptureAiGenerationOptions, type PromptCodeFallbackResult, type PromptRemoteResult, type PromptResult, Prompts, captureAiGeneration, wrapVercelLanguageModel as withTracing };
+export { AIEvent, type CaptureAiGenerationOptions, type PromptCodeFallbackResult, PromptFetchError, type PromptRemoteResult, type PromptResult, Prompts, captureAiGeneration, wrapVercelLanguageModel as withTracing };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.mjs

@@ -395,7 +395,7 @@ function sanitizeValues(obj) {
 }
 //#endregion
 //#region package.json
-var version = "8.13.5";
+var version = "8.13.7";
 //#endregion
 //#region src/serializeError.ts
 const DEFAULT_MAX_DEPTH = 3;
@@ -1090,6 +1090,7 @@ const DEFAULT_PROMPTS_HOST = "https://us.posthog.com";
 const MAX_PROMPT_LIST_PAGES = 100;
 const DEFAULT_REFETCH_COOLDOWN_SECONDS = 60;
 const MAX_REFETCH_COOLDOWN_SECONDS = 3600;
+const FETCH_TIMEOUT_MS = 1e4;
 function normalizeApiKey(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
@@ -1125,6 +1126,30 @@ function isPromptApiResponse(data) {
 	const record = data;
 	return typeof record.prompt === "string" && typeof record.name === "string" && typeof record.version === "number" && (record.label === void 0 || typeof record.label === "string");
 }
+/**
+* GET with the client's timeout. The timer is cleared only after the body is
+* read, so a response whose headers arrive but whose body stalls still times out.
+*/
+async function fetchJsonWithTimeout(url, personalApiKey, timeoutReference) {
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(new PromptFetchError(`[PostHog Prompts] Timed out fetching ${timeoutReference} after ${FETCH_TIMEOUT_MS}ms`)), FETCH_TIMEOUT_MS);
+	try {
+		const response = await fetch(url, {
+			method: "GET",
+			headers: { Authorization: `Bearer ${personalApiKey}` },
+			signal: controller.signal
+		});
+		return {
+			response,
+			data: response.ok ? await response.json() : void 0
+		};
+	} catch (error) {
+		if (controller.signal.aborted) throw controller.signal.reason;
+		throw error;
+	} finally {
+		clearTimeout(timer);
+	}
+}
 function isSameOrigin(url, host) {
 	try {
 		return new URL(url).origin === new URL(host).origin;
@@ -1204,6 +1229,7 @@ function isPromptsWithPostHog(options) {
 var Prompts = class {
 	constructor(options) {
 		this.cache = /* @__PURE__ */ new Map();
+		this.inFlight = /* @__PURE__ */ new Map();
 		this.defaultCacheTtlSeconds = options.defaultCacheTtlSeconds ?? DEFAULT_CACHE_TTL_SECONDS;
 		if (isPromptsWithPostHog(options)) {
 			this.personalApiKey = options.posthog.options.personalApiKey ?? "";
@@ -1348,7 +1374,7 @@ var Prompts = class {
 			};
 		}
 		try {
-			const fetched = await this.fetchPromptFromApi(name, version, label);
+			const fetched = await this.fetchPromptOnce(name, version, label);
 			if (label !== void 0 && fetched.label !== label) console.warn(`[PostHog Prompts] Requested label "${label}" for prompt "${name}" but the server resolved ${fetched.label === void 0 ? "no label" : `"${fetched.label}"`}. It may not support prompt labels yet and returned the latest version instead.`);
 			this.getOrCreatePromptCache(name).set(cacheEntryKey, {
 				...fetched,
@@ -1372,6 +1398,20 @@ var Prompts = class {
 			throw error;
 		}
 	}
+	fetchPromptOnce(name, version, label) {
+		const inFlightKey = JSON.stringify([
+			name,
+			version ?? null,
+			label ?? null
+		]);
+		const pending = this.inFlight.get(inFlightKey);
+		if (pending !== void 0) return pending;
+		const request = this.fetchPromptFromApi(name, version, label).finally(() => {
+			this.inFlight.delete(inFlightKey);
+		});
+		this.inFlight.set(inFlightKey, request);
+		return request;
+	}
 	readCacheEntry(cached) {
 		const { fetchedAt: _fetchedAt, retryNotBefore: _retryNotBefore, ...cachedResult } = cached;
 		return {
@@ -1438,15 +1478,11 @@ var Prompts = class {
 		let pages = 0;
 		while (url !== void 0) {
 			if (pages >= MAX_PROMPT_LIST_PAGES) throw new Error(`[PostHog Prompts] ${reference} spans more than ${MAX_PROMPT_LIST_PAGES} pages. Refusing to return an incomplete result.`);
-			const response = await fetch(url, {
-				method: "GET",
-				headers: { Authorization: `Bearer ${this.personalApiKey}` }
-			});
+			const { response, data } = await fetchJsonWithTimeout(url, this.personalApiKey, reference);
 			if (!response.ok) {
 				if (response.status === 403) throw new Error(`[PostHog Prompts] Access denied for ${reference}. Check that your personalApiKey has the correct permissions and the LLM prompts feature is enabled.`);
 				throw new PromptFetchError(`[PostHog Prompts] Failed to fetch ${reference}: HTTP ${response.status}`, response.status === 429 ? parseRetryAfterSeconds(response.headers?.get("Retry-After")) : void 0);
 			}
-			const data = await response.json();
 			if (typeof data !== "object" || data === null || !Array.isArray(data.results)) throw new Error(`[PostHog Prompts] Invalid response format for ${reference}`);
 			rows.push(...data.results);
 			const nextUrl = data.next;
@@ -1463,17 +1499,12 @@ var Prompts = class {
 		const versionQuery = version === void 0 ? "" : `&version=${encodeURIComponent(String(version))}`;
 		const labelQuery = label === void 0 ? "" : `&label=${encodeURIComponent(label)}`;
 		const promptReference = this.getPromptReference(name, version, label);
-		const url = `${this.host}/api/environments/@current/llm_prompts/name/${encodedPromptName}/?token=${encodedProjectApiKey}${versionQuery}${labelQuery}`;
-		const response = await fetch(url, {
-			method: "GET",
-			headers: { Authorization: `Bearer ${this.personalApiKey}` }
-		});
+		const { response, data } = await fetchJsonWithTimeout(`${this.host}/api/environments/@current/llm_prompts/name/${encodedPromptName}/?token=${encodedProjectApiKey}${versionQuery}${labelQuery}`, this.personalApiKey, `prompt ${promptReference}`);
 		if (!response.ok) {
 			if (response.status === 404) throw new Error(`[PostHog Prompts] Prompt ${promptReference} not found`);
 			if (response.status === 403) throw new Error(`[PostHog Prompts] Access denied for prompt ${promptReference}. Check that your personalApiKey has the correct permissions and the LLM prompts feature is enabled.`);
 			throw new PromptFetchError(`[PostHog Prompts] Failed to fetch prompt ${promptReference}: HTTP ${response.status}`, response.status === 429 ? parseRetryAfterSeconds(response.headers?.get("Retry-After")) : void 0);
 		}
-		const data = await response.json();
 		if (!isPromptApiResponse(data)) throw new Error(`[PostHog Prompts] Invalid response format for prompt ${promptReference}`);
 		return {
 			prompt: data.prompt,
@@ -1485,6 +1516,6 @@ var Prompts = class {
 	}
 };
 //#endregion
-export { AIEvent, Prompts, captureAiGeneration, wrapVercelLanguageModel as withTracing };
+export { AIEvent, PromptFetchError, Prompts, captureAiGeneration, wrapVercelLanguageModel as withTracing };
 
 //# sourceMappingURL=index.mjs.map